mso_role – Управление ролями

Новая версия с 2.8.

Обзор
Требования
Параметры
Примечания
Примеры
Статус

Обзор

Управление ролями в Cisco ACI Multi-Site.

Требования

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

Multi Site Orchestrator v2.1 или более поздней версии

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
description строка		Описание роли.
display_name строка		Имя роли для отображения в веб-интерфейсе.
host строка / обязательно		IP-адрес или имя хоста ACI Multi Site Orchestrator. псевдонимы: имя хоста
output_level строка	Варианты: debug info normal ←	Влияет на вывод этого модуля ACI. `normal` означает стандартный вывод, включая `current` словарь. `info` добавляет информативный вывод, включая `previous`, `proposed` и `sent` словари. `debug` добавляет отладочный вывод, включая `filter_string`, `method`, `response`, `status` и `url` информацию.
password строка / обязательно		Пароль для аутентификации. Этот параметр взаимоисключающий с `private_key`. Если `private_key` также предоставлен, он будет использован вместо него.
permissions список	Варианты: backup-db manage-audit-records manage-labels manage-roles manage-schemas manage-sites manage-tenants manage-tenant-schemas manage-users platform-logs view-all-audit-records view-labels view-roles view-schemas view-sites view-tenants view-tenant-schemas view-users	Список разрешений, связанных с этой ролью.
port целое число		Номер порта для подключения REST. Значение по умолчанию зависит от параметра `use_ssl`.
role строка / обязательно		Имя роли. псевдонимы: имя
state строка	Варианты: absent present ← query	Используйте `present` или `absent` для добавления или удаления. Используйте `query` для получения списка объекта или нескольких объектов.
timeout целое число	По умолчанию: 30	Таймаут уровня сокета в секундах.
use_proxy логическое значение	Варианты: no yes ←	Если `no`, прокси не будет использоваться, даже если он определён в переменной окружения на целевых хостах.
use_ssl логическое значение	Варианты: no yes ←	Если `no`, будет использовано HTTP-соединение вместо стандартного HTTPS-соединения.
username строка	По умолчанию: "admin"	Имя пользователя для аутентификации.
validate_certs логическое значение	Варианты: no yes ←	Если `no`, сертификаты SSL не будут проверены. Это должно быть установлено только в `no` при использовании на контролируемых сайтах с самоподписанными сертификатами.

Примечания

Примечание

Для получения более подробной информации о том, как управлять вашей инфраструктурой ACI с помощью Ansible, обратитесь к Руководству по Cisco ACI.
Этот модуль был написан для поддержки ACI Multi Site Orchestrator версии 2.1 или более поздней. Некоторая или вся функциональность может не работать на более ранних версиях.

Примеры

- name: Add a new role
  mso_role:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    role: readOnly
    display_name: Read Only
    description: Read-only access for troubleshooting
    permissions:
    - view-roles
    - view-schemas
    - view-sites
    - view-tenants
    - view-tenant-schemas
    - view-users
    state: present
  delegate_to: localhost

- name: Remove a role
  mso_role:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    role: readOnly
    state: absent
  delegate_to: localhost

- name: Query a role
  mso_role:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    role: readOnly
    state: query
  delegate_to: localhost
  register: query_result

- name: Query all roles
  mso_role:
    host: mso_host
    username: admin
    password: SomeSecretPassword
    state: query
  delegate_to: localhost
  register: query_result

Состояние

Гарантия обратной совместимости для этого модуля отсутствует. [предварительный просмотр]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Dag Wieers (@dagwieers)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 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/mso_role_module.html