rundeck_acl_policy – Manage Rundeck ACL policies
rundeck_acl_policy – Manage Rundeck ACL policies
New in version 2.4.
Synopsis
- Create, update and remove Rundeck ACL policies through HTTP API.
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
api_version - |
Default: 14 |
Sets the API version used by module. API version must be at least 14. |
name - / required |
Sets the project name. | |
policy - |
Sets the ACL policy content. ACL policy content is a YAML object as described in http://rundeck.org/docs/man5/aclpolicy.html. It can be a YAML string or a pure Ansible inventory YAML object. | |
project - |
Sets the project which receive the ACL policy. If unset, it's a system ACL policy. | |
state - |
|
Create or remove Rundeck project. |
token - / required |
Sets the token to authenticate against Rundeck API. | |
url - / required |
Sets the rundeck instance URL. |
Examples
- name: Create or update a rundeck ACL policy in project Ansible
rundeck_acl_policy:
name: "Project_01"
api_version: 18
url: "https://rundeck.example.org"
token: "mytoken"
state: present
project: "Ansible"
policy:
description: "my policy"
context:
application: rundeck
for:
project:
- allow: read
by:
group: "build"
- name: Remove a rundeck system policy
rundeck_acl_policy:
name: "Project_02"
url: "https://rundeck.example.org"
token: "mytoken"
state: absent
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
after dictionary |
success |
Dictionary containing ACL policy informations after modification.
|
before dictionary |
success |
Dictionary containing ACL policy informations before modification.
|
rundeck_response string |
failed |
Rundeck response when a failure occurs.
|
Status
- This module is not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]
Authors
- Loic Blot (@nerzhul)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/rundeck_acl_policy_module.html