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` только при использовании на сайтах с собственными самоподписанными сертификатами.

Примечания

Примечание

Пожалуйста, ознакомьтесь с Руководством по Cisco ACI, чтобы получить более подробную информацию о том, как управлять инфраструктурой ACI с помощью Ansible.
Этот модуль был разработан для поддержки ACI Multi Site Orchestrator v2.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.9/modules/mso_role_module.html