# Source: https://docs.datadoghq.com/ddsql_reference/data_directory/gcp/gcp.pubsub_topic.dataset.md

---
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<string> |
| 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<string> | 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        |