gcpubsub_facts – List Topics/Subscriptions and Messages from Google PubSub
gcpubsub_facts – List Topics/Subscriptions and Messages from Google PubSub
New in version 2.3.
Synopsis
- List Topics/Subscriptions from Google PubSub. Use the gcpubsub module for topic/subscription management. See https://cloud.google.com/pubsub/docs for an overview.
Requirements
The below requirements are needed on the host that executes this module.
- python >= 2.6
- google-auth >= 0.5.0
- google-cloud-pubsub >= 0.22.0
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
state - |
list is the only valid option. | |
topic - |
GCP pubsub topic name. Only the name, not the full path, is required. | |
view - / required |
Choices are 'topics' or 'subscriptions' |
Notes
Note
- list state enables user to list topics or subscriptions in the project. See examples for details.
Examples
## List all Topics in a project
- gcpubsub_facts:
view: topics
state: list
## List all Subscriptions in a project
- gcpubsub_facts:
view: subscriptions
state: list
## List all Subscriptions for a Topic in a project
- gcpubsub_facts:
view: subscriptions
topic: my-topic
state: list
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
subscriptions list |
When view is set to subscriptions. |
List of subscriptions.
Sample: ['mysubscription', 'mysubscription2'] |
topic string |
Always |
Name of topic. Used to filter subscriptions.
Sample: mytopic |
topics list |
When view is set to topics. |
List of topics.
Sample: ['mytopic', 'mytopic2'] |
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Tom Melendez (@supertom) <[email protected]>
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/gcpubsub_facts_module.html