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_team - create, update, or destroy Ansible Tower team.¶

New in version 2.3.

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

Synopsis ¶

Create, update, or destroy Ansible Tower teams. 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 team.
organization	yes			Organization the team should be made a member of.
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: Create tower team
  tower_team:
    name: Team Name
    description: Team Description
    organization: test-org
    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.