community / community.general / 2.5.9 / module / manageiq_tags Management of resource tags in ManageIQ. Authors: Daniel Korn (@dkorn)community.general.manageiq_tags (2.5.9) — module
Install with ansible-galaxy collection install community.general:==2.5.9
collections: - name: community.general version: 2.5.9
The manageiq_tags module supports adding, updating and deleting tags in ManageIQ.
- name: Create new tags for a provider in ManageIQ community.general.manageiq_tags: resource_name: 'EngLab' resource_type: 'provider' tags: - category: environment name: prod - category: owner name: prod_ops manageiq_connection: url: 'http://127.0.0.1:3000' username: 'admin' password: 'smartvm' validate_certs: False
- name: Create new tags for a provider in ManageIQ community.general.manageiq_tags: resource_id: 23000000790497 resource_type: 'provider' tags: - category: environment name: prod - category: owner name: prod_ops manageiq_connection: url: 'http://127.0.0.1:3000' username: 'admin' password: 'smartvm' validate_certs: False
- name: Remove tags for a provider in ManageIQ community.general.manageiq_tags: state: absent resource_name: 'EngLab' resource_type: 'provider' tags: - category: environment name: prod - category: owner name: prod_ops manageiq_connection: url: 'http://127.0.0.1:3000' username: 'admin' password: 'smartvm' validate_certs: False
- name: List current tags for a provider in ManageIQ community.general.manageiq_tags: state: list resource_name: 'EngLab' resource_type: 'provider' manageiq_connection: url: 'http://127.0.0.1:3000' username: 'admin' password: 'smartvm' validate_certs: False
tags: description: - tags - list of dictionaries, each includes 'name' and 'category' keys. - required if state is present or absent. elements: dict type: list state: choices: - absent - present - list default: present description: - absent - tags should not exist, - present - tags should exist, - list - list current tags. type: str resource_id: description: - The ID of the resource at which tags will be controlled. - Must be specified if I(resource_name) is not set. Both options are mutually exclusive. type: int version_added: 2.2.0 version_added_collection: community.general resource_name: description: - The name of the resource at which tags will be controlled. - Must be specified if I(resource_id) is not set. Both options are mutually exclusive. type: str resource_type: choices: - provider - host - vm - blueprint - category - cluster - data store - group - resource pool - service - service template - template - tenant - user description: - The relevant resource type in manageiq. required: true type: str manageiq_connection: description: - ManageIQ connection configuration information. required: false suboptions: ca_cert: aliases: - ca_bundle_path description: - The path to a CA bundle file or directory with certificates. defaults to None. type: str password: description: - ManageIQ password. C(MIQ_PASSWORD) env var if set. otherwise, required if no token is passed in. type: str token: description: - ManageIQ token. C(MIQ_TOKEN) env var if set. otherwise, required if no username or password is passed in. type: str url: description: - ManageIQ environment url. C(MIQ_URL) env var if set. otherwise, it is required to pass it. required: false type: str username: description: - ManageIQ username. C(MIQ_USERNAME) env var if set. otherwise, required if no token is passed in. type: str validate_certs: aliases: - verify_ssl default: true description: - Whether SSL certificates should be verified for HTTPS requests. defaults to True. type: bool type: dict