alancoding / alancoding.awx / 11.2.0 / module / tower_role grant or revoke an Ansible Tower role. | "added in version" 2.3 of alancoding.awx" Authors: Wayne Witzel III (@wwitzel3) preview | supported by communityalancoding.awx.tower_role (11.2.0) — module
Install with ansible-galaxy collection install alancoding.awx:==11.2.0
collections: - name: alancoding.awx version: 11.2.0
Roles are used for access control, this module is for managing user access to server resources.
Grant or revoke Ansible Tower roles to users. See U(https://www.ansible.com/tower) for an overview.
- name: Add jdoe to the member role of My Team tower_role: user: jdoe target_team: "My Team" role: member state: present
role: choices: - admin - read - member - execute - adhoc - update - use - auditor - project_admin - inventory_admin - credential_admin - workflow_admin - notification_admin - job_template_admin description: - The role type to grant/revoke. required: true type: str team: description: - Team that receives the permissions specified by the role. type: str user: description: - User that receives the permissions specified by the role. type: str state: choices: - present - absent default: present description: - Desired state. - State of present indicates the user should have the role. - State of absent indicates the user should have the role taken away, if they have it. type: str project: description: - Project the role acts on. type: str workflow: description: - The workflow job template the role acts on. type: str inventory: description: - Inventory the role acts on. type: str credential: description: - Credential the role acts on. type: str tower_host: description: - URL to your Tower or AWX instance. - If value not set, will try environment variable C(TOWER_HOST) and then config files - If value not specified by any means, the value of C(127.0.0.1) will be used type: str target_team: description: - Team that the role acts on. - For example, make someone a member or an admin of a team. - Members of a team implicitly receive the permissions that the team has. type: str job_template: description: - The job template the role acts on. type: str organization: description: - Organization the role acts on. type: str tower_password: description: - Password for your Tower or AWX instance. - If value not set, will try environment variable C(TOWER_PASSWORD) and then config files type: str tower_username: description: - Username for your Tower or AWX instance. - If value not set, will try environment variable C(TOWER_USERNAME) and then config files type: str validate_certs: aliases: - tower_verify_ssl description: - Whether to allow insecure connections to Tower or AWX. - If C(no), SSL certificates will not be validated. - This should only be used on personally controlled sites using self-signed certificates. - If value not set, will try environment variable C(TOWER_VERIFY_SSL) and then config files type: bool tower_oauthtoken: description: - The Tower OAuth token to use. - If value not set, will try environment variable C(TOWER_OAUTH_TOKEN) and then config files type: str version_added: '3.7' version_added_collection: alancoding.awx tower_config_file: description: - Path to the Tower or AWX config file. type: path