REST Resource: projects.topics

Resource: Topic

A topic resource.

JSON representation 
{
  "name": string,
  "labels": {
    string: string,
    ...
  },
  "messageStoragePolicy": {
    object (MessageStoragePolicy)
  },
  "kmsKeyName": string
}
Fields
name

string

Name of the topic. Format is projects/{project}/topics/{topic}.

labels

map (key: string, value: string)

See Creating and managing labels.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
messageStoragePolicy

object (MessageStoragePolicy)

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.

kmsKeyName

string

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/*.

MessageStoragePolicy

JSON representation 
{
  "allowedPersistenceRegions": [
    string
  ]
}
Fields
allowedPersistenceRegions[]

string

A list of IDs of GCP regions where messages that are published to the topic may be persisted in storage. Messages published by publishers running in non-allowed GCP regions (or running outside of GCP altogether) will be routed for storage in one of the allowed regions. An empty list means that no regions are allowed, and is not a valid configuration.

Methods

create

 Creates the given topic with the given name.

delete

 Deletes the topic with the given name.

get

 Gets the configuration of a topic.

getIamPolicy

 Gets the access control policy for a resource.

list

 Lists matching topics.

publish

 Adds one or more messages to the topic.

setIamPolicy

 Sets the access control policy on the specified resource.

testIamPermissions

 Returns permissions that a caller has on the specified resource.