ansible / ansible.builtin / v2.5.11 / module / cs_role Manages user roles on Apache CloudStack based clouds. | "added in version" 2.3 of ansible.builtin" Authors: René Moser (@resmo) preview | supported by communityansible.builtin.cs_role (v2.5.11) — module
pip
Install with pip install ansible==2.5.11
Create, update, delete user roles.
# Ensure an user role is present - local_action: module: cs_role name: myrole_user
# Ensure a role having particular ID is named as myrole_user - local_action: module: cs_role name: myrole_user id: 04589590-ac63-4ffc-93f5-b698b8ac38b6
# Ensure a role is absent - local_action: module: cs_role name: myrole_user state: absent
id: aliases: - uuid default: null description: - ID of the role. - If provided, C(id) is used as key. required: false name: description: - Name of the role. required: true state: choices: - present - absent default: present description: - State of the role. required: false api_key: description: - API key of the CloudStack API. - If not given, the C(CLOUDSTACK_KEY) env variable is considered. required: true type: str api_url: description: - URL of the CloudStack API e.g. https://cloud.example.com/client/api. - If not given, the C(CLOUDSTACK_ENDPOINT) env variable is considered. required: true type: str role_type: choices: - User - DomainAdmin - ResourceAdmin - Admin default: User description: - Type of the role. - Only considered for creation. required: false api_secret: description: - Secret key of the CloudStack API. - If not set, the C(CLOUDSTACK_SECRET) env variable is considered. required: true type: str api_timeout: default: 10 description: - HTTP timeout in seconds. - If not given, the C(CLOUDSTACK_TIMEOUT) env variable is considered. type: int description: default: null description: - Description of the role. required: false api_http_method: choices: - get - post default: get description: - HTTP method used to query the API endpoint. - If not given, the C(CLOUDSTACK_METHOD) env variable is considered. type: str api_verify_ssl_cert: description: - Verify CA authority cert file. - If not given, the C(CLOUDSTACK_VERIFY) env variable is considered. type: str
description: description: Description of the role. returned: success sample: This is my role description type: string id: description: UUID of the role. returned: success sample: 04589590-ac63-4ffc-93f5-b698b8ac38b6 type: string name: description: Name of the role. returned: success sample: myrole type: string role_type: description: Type of the role. returned: success sample: User type: string