community.digitalocean.digital_ocean_tag_info – Gather information about DigitalOcean tags¶
Note
This plugin is part of the community.digitalocean collection (version 1.0.0).
To install it use: ansible-galaxy collection install community.digitalocean
.
To use it in a playbook, specify: community.digitalocean.digital_ocean_tag_info
.
Synopsis¶
This module can be used to gather information about DigitalOcean provided tags.
This module was called
digital_ocean_tag_facts
before Ansible 2.9. The usage did not change.
Requirements¶
The below requirements are needed on the host that executes this module.
python >= 2.6
Parameters¶
Examples¶
- name: Gather information about all tags
community.digitalocean.digital_ocean_tag_info:
oauth_token: "{{ oauth_token }}"
- name: Gather information about tag with given name
community.digitalocean.digital_ocean_tag_info:
oauth_token: "{{ oauth_token }}"
tag_name: "extra_awesome_tag"
- name: Get resources from tag name
community.digitalocean.digital_ocean_tag_info:
register: resp_out
- set_fact:
resources: "{{ item.resources }}"
loop: "{{ resp_out.data | community.general.json_query(name) }}"
vars:
name: "[?name=='extra_awesome_tag']"
- debug:
var: resources
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
data
list
/ elements=string
|
success |
DigitalOcean tag information
Sample:
[{'name': 'extra-awesome', 'resources': {'droplets': {'...': None, 'count': 1}}}]
|
Authors¶
Abhijeet Kasurde (@Akasurde)