You are reading an unmaintained version of the Ansible documentation. Unmaintained Ansible versions can contain unfixed security vulnerabilities (CVE). Please upgrade to a maintained version. See the latest Ansible documentation.

tower_label - create, update, or destroy Ansible Tower label.¶

New in version 2.3.

Synopsis
Requirements (on host that executes module)
Options
Examples
Notes
- Status

Synopsis ¶

Create, update, or destroy Ansible Tower labels. See https://www.ansible.com/tower for an overview.

Requirements (on host that executes module)¶

python >= 2.6

ansible-tower-cli >= 3.0.3

Options ¶

parameter	required	default	choices	comments
name	yes			Name to use for the label.
organization	yes			Organization the label should be applied to.
state	no	present	present absent	Desired state of the resource.
tower_config_file	no			Path to the Tower config file. See notes.
tower_host	no			URL to your Tower instance.
tower_password	no			Password for your Tower instance.
tower_username	no			Username for your Tower instance.
tower_verify_ssl	no	True		Dis/allow insecure connections to Tower. If `no`, SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates.

Examples ¶

- name: Add label to tower organization
  tower_label:
    name: Custom Label
    organization: My Organization
    state: present
    tower_config_file: "~/tower_cli.cfg"

Notes ¶

Note

If no config_file is provided we will attempt to use the tower-cli library defaults to find your Tower host information.
config_file should contain Tower configuration in the following format host=hostname username=username password=password

Status ¶

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

For help in developing on modules, should you be so inclined, please read Community Information & Contributing, Testing Ansible and Developing Modules.