Spec-Zone.ru › Ansible

Модуль ngine_io.cloudstack.cs_role – Управление ролями пользователей в облаках на основе Apache CloudStack.

Примечание

Этот модуль является частью коллекции ngine_io.cloudstack (версия 2.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install ngine_io.cloudstack. Для использования этого модуля необходимы дополнительные требования, см. Требования для получения подробной информации.

Для использования в playbook укажите: ngine_io.cloudstack.cs_role.

Новое в ngine_io.cloudstack 0.1.0

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Создание, обновление, удаление ролей пользователей.

Требования

Ниже приведены требования, необходимые на хосте, который выполняет этот модуль.

  • python >= 2.6
  • cs >= 0.9.0

Параметры

Параметр

Комментарии

api_http_method

строка

HTTP-метод, используемый для запроса к конечной точке API.

Если не указан, учитывается переменная среды CLOUDSTACK_METHOD.

Варианты:

  • "get" ← (по умолчанию)
  • "post"

api_key

строка / обязательно

Ключ API CloudStack API.

Если не указан, учитывается переменная среды CLOUDSTACK_KEY.

api_secret

строка / обязательно

Секретный ключ CloudStack API.

Если не указан, учитывается переменная среды CLOUDSTACK_SECRET.

api_timeout

целое число

Таймаут HTTP в секундах.

Если не указан, учитывается переменная среды CLOUDSTACK_TIMEOUT.

По умолчанию: 10

api_url

строка / обязательно

URL CloudStack API, например https://cloud.example.com/client/api.

Если не указан, учитывается переменная среды CLOUDSTACK_ENDPOINT.

api_verify_ssl_cert

строка

Проверка файла сертификата центра сертификации.

Если не указан, учитывается переменная среды CLOUDSTACK_VERIFY.

description

строка

Описание роли.

name

строка / обязательно

Название роли.

role_type

строка

Тип роли.

Учитывается только при создании.

Варианты:

  • "User" ← (по умолчанию)
  • "DomainAdmin"
  • "ResourceAdmin"
  • "Admin"

state

строка

Состояние роли.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

uuid

псевдонимы: id

строка

ID роли.

Если указано, uuid используется как ключ.

validate_certs

логическое значение

добавлено в ngine_io.cloudstack 2.4.0

Если false, SSL-сертификаты проверяться не будут.

Если не указан, учитывается переменная среды CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY.

Это следует использовать только на лично контролируемых сайтах, использующих самозаверенные сертификаты.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

  • Подробное руководство по модулям 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

строка

Описание роли.

Возвращается: успех

Пример: "This is my role description"

id

строка

UUID роли.

Возвращается: успех

Пример: "04589590-ac63-4ffc-93f5-b698b8ac38b6"

name

строка

Имя роли.

Возвращается: успех

Пример: "myrole"

role_type

строка

Тип роли.

Возвращается: успех

Пример: "User"

Авторы

  • René Moser (@resmo)

Ссылки на сборку

  • Система отслеживания ошибок
  • Репозиторий (исходные коды)

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/ngine_io/cloudstack/cs_role_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API