REST Resource: projects.topics

• Resource: Topic
  • JSON representation
• MessageStoragePolicy
  • JSON representation
• Methods

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.