ngine_io.cloudstack.cs_role – Управляет ролями пользователей в облаках на основе Apache CloudStack.
Примечание
Этот плагин является частью коллекции ngine_io.cloudstack (версия 2.0.0).
Для его установки используйте: ansible-galaxy collection install ngine_io.cloudstack
Для использования в книге задач укажите: ngine_io.cloudstack.cs_role
Новое в версии 0.1.0: модуля ngine_io.cloudstack
Обзор
- Создание, обновление, удаление ролей пользователей.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- cs >= 0.9.0
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_http_method строка |
| Метод HTTP, используемый для запроса к API-точке входа. Если не указано, рассматривается переменная среды CLOUDSTACK_METHOD |
| api_key строка / обязательный | Ключ API API CloudStack. Если не указано, рассматривается переменная среды CLOUDSTACK_KEY | |
| api_secret строка / обязательный | Секретный ключ API CloudStack. Если не задано, рассматривается переменная среды CLOUDSTACK_SECRET | |
| api_timeout целое число | По умолчанию: 10 | Таймаут HTTP в секундах. Если не указано, рассматривается переменная среды CLOUDSTACK_TIMEOUT |
| api_url строка / обязательный | URL API CloudStack, например, https://cloud.example.com/client/api. Если не указано, рассматривается переменная среды CLOUDSTACK_ENDPOINT | |
| api_verify_ssl_cert строка | Проверка файла сертификата авторитета CA. Если не указано, рассматривается переменная среды CLOUDSTACK_VERIFY | |
| description строка | Описание роли. | |
| name строка / обязательный | Имя роли. | |
| role_type строка |
| Тип роли. Рассматривается только при создании. |
| state строка |
| Состояние роли. |
| uuid строка | Идентификатор роли. Если указано, uuid используется в качестве ключа. псевдонимы: id |
Примечания
Примечание
- Подробное руководство по модулям cloudstack можно найти в Руководстве по облакам CloudStack.
- Этот модуль поддерживает режим проверки.
Примеры
- name: Ensure an user role is present
ngine_io.cloudstack.cs_role:
name: myrole_user
- name: Ensure a role having particular ID is named as myrole_user
ngine_io.cloudstack.cs_role:
name: myrole_user
id: 04589590-ac63-4ffc-93f5-b698b8ac38b6
- name: Ensure a role is absent
ngine_io.cloudstack.cs_role:
name: myrole_user
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| description строка | success | Описание роли. Пример: Это описание моей роли |
| id строка | success | UUID роли. Пример: 04589590-ac63-4ffc-93f5-b698b8ac38b6 |
| name строка | success | Имя роли. Пример: myrole |
| role_type строка | success | Тип роли. Пример: Пользователь |
Авторы
- René Moser (@resmo)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ngine_io/cloudstack/cs_role_module.html