ovirt_tag_info – Retrieve information about one or more oVirt/RHV tags¶
Synopsis¶
- Retrieve information about one or more oVirt/RHV tags.
- This module was called ovirt_tag_factsbefore Ansible 2.9, returningansible_facts. Note that the ovirt_tag_info module no longer returnsansible_facts!
Aliases: ovirt_tag_facts
Requirements¶
The below requirements are needed on the host that executes this module.
- python >= 2.7
- ovirt-engine-sdk-python >= 4.3.0
Parameters¶
Notes¶
Note
- This module returns a variable ovirt_tags, which contains a list of tags. You need to register the result with the register keyword to use it.
- In order to use this module you have to install oVirt Python SDK. To ensure it’s installed with correct version you can create the following task: pip: name=ovirt-engine-sdk-python version=4.3.0
Examples¶
# Examples don't contain auth parameter for simplicity,
# look at ovirt_auth module to see how to reuse authentication:
# Gather information about all tags, which names start with C(tag):
- ovirt_tag_info:
    name: tag*
  register: result
- debug:
    msg: "{{ result.ovirt_tags }}"
# Gather information about all tags, which are assigned to VM C(postgres):
- ovirt_tag_info:
    vm: postgres
  register: result
- debug:
    msg: "{{ result.ovirt_tags }}"
# Gather information about all tags, which are assigned to host C(west):
- ovirt_tag_info:
    host: west
  register: result
- debug:
    msg: "{{ result.ovirt_tags }}"
Return Values¶
Common return values are documented here, the following are the fields unique to this module:
Status¶
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors¶
- Ondra Machacek (@machacekondra)
Hint
If you notice any issues in this documentation, you can edit this document to improve it.
