community / community.general / 0.1.1 / module / cs_role Manages user roles on Apache CloudStack based clouds. Authors: René Moser (@resmo) preview | supported by communitycommunity.general.cs_role (0.1.1) — module
Install with ansible-galaxy collection install community.general:==0.1.1
collections: - name: community.general version: 0.1.1
Create, update, delete user roles.
- name: Ensure an user role is present cs_role: name: myrole_user delegate_to: localhost
- name: Ensure a role having particular ID is named as myrole_user cs_role: name: myrole_user id: 04589590-ac63-4ffc-93f5-b698b8ac38b6 delegate_to: localhost
- name: Ensure a role is absent cs_role: name: myrole_user state: absent delegate_to: localhost
name: description: - Name of the role. required: true type: str uuid: aliases: - id description: - ID of the role. - If provided, I(uuid) is used as key. type: str state: choices: - present - absent default: present description: - State of the role. type: str api_key: description: - API key of the CloudStack API. - If not given, the C(CLOUDSTACK_KEY) env variable is considered. - As the last option, the value is taken from the ini config file, also see the notes. 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. - As the last option, the value is taken from the ini config file, also see the notes. type: str role_type: choices: - User - DomainAdmin - ResourceAdmin - Admin default: User description: - Type of the role. - Only considered for creation. type: str api_region: default: cloudstack description: - Name of the ini section in the C(cloustack.ini) file. - If not given, the C(CLOUDSTACK_REGION) env variable is considered. type: str api_secret: description: - Secret key of the CloudStack API. - If not set, the C(CLOUDSTACK_SECRET) env variable is considered. - As the last option, the value is taken from the ini config file, also see the notes. type: str api_timeout: description: - HTTP timeout in seconds. - If not given, the C(CLOUDSTACK_TIMEOUT) env variable is considered. - As the last option, the value is taken from the ini config file, also see the notes. - Fallback value is 10 seconds if not specified. type: int description: description: - Description of the role. type: str api_http_method: choices: - get - post description: - HTTP method used to query the API endpoint. - If not given, the C(CLOUDSTACK_METHOD) env variable is considered. - As the last option, the value is taken from the ini config file, also see the notes. - Fallback value is C(get) if not specified. type: str
description: description: Description of the role. returned: success sample: This is my role description type: str id: description: UUID of the role. returned: success sample: 04589590-ac63-4ffc-93f5-b698b8ac38b6 type: str name: description: Name of the role. returned: success sample: myrole type: str role_type: description: Type of the role. returned: success sample: User type: str