--- title: Pub/Sub Topic description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > DDSQL Reference > Data Directory > Pub/Sub Topic --- # Pub/Sub Topic A Pub/Sub Topic in Google Cloud is a messaging resource that allows applications to send messages asynchronously. Publishers send messages to a topic, and subscribers receive them from subscriptions linked to that topic. It enables decoupled communication between services, supporting scalable, reliable, and real-time event-driven architectures. ``` gcp.pubsub_topic ``` ## Fields | Title | ID | Type | Data Type | Description | | ------------------------------ | ---- | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | | _key | core | string | | ancestors | core | array | | datadog_display_name | core | string | | ingestion_data_source_settings | core | json | Optional. Settings for ingestion from a data source into this topic. | | kms_key_name | core | string | Optional. The resource name of the Cloud KMS CryptoKey to be used to protect access to messages published on this topic. The expected format is `projects/*/locations/*/keyRings/*/cryptoKeys/*`. | | labels | core | array | Optional. See [Creating and managing labels] (https://cloud.google.com/pubsub/docs/labels). | | message_retention_duration | core | string | Optional. Indicates the minimum duration to retain a message after it is published to the topic. If this field is set, messages published to the topic in the last `message_retention_duration` are always available to subscribers. For instance, it allows any attached subscription to [seek to a timestamp](https://cloud.google.com/pubsub/docs/replay-overview#seek_to_a_time) that is up to `message_retention_duration` in the past. If this field is not set, message retention is controlled by settings on individual subscriptions. Cannot be more than 31 days or less than 10 minutes. | | message_storage_policy | core | json | Optional. Policy constraining the set of Google Cloud Platform regions where messages published to the topic may be stored. If not present, then no constraints are in effect. | | message_transforms | core | json | Optional. Transforms to be applied to messages published to the topic. Transforms are applied in the order specified. | | name | core | string | Required. Identifier. The name of the topic. It must have the format `"projects/{project}/topics/{topic}"`. `{topic}` must start with a letter, and contain only letters (`[A-Za-z]`), numbers (`[0-9]`), dashes (`-`), underscores (`_`), periods (`.`), tildes (`~`), plus (`+`) or percent signs (`%`). It must be between 3 and 255 characters in length, and it must not start with `"goog"`. | | organization_id | core | string | | parent | core | string | | project_id | core | string | | project_number | core | string | | region_id | core | string | | resource_name | core | string | | satisfies_pzs | core | bool | Optional. Reserved for future use. This field is set only in responses from the server; it is ignored if it is set in any requests. | | schema_settings | core | json | Optional. Settings for validating messages published against a schema. | | state | core | string | Output only. An output-only field indicating the state of the topic. | | tags | core | hstore_csv | | zone_id | core | string |