theforeman.foreman.role – Управление ролями
Примечание
Этот плагин входит в коллекцию theforeman.foreman (версия 1.5.1).
Для установки используйте: ansible-galaxy collection install theforeman.foreman.
Для использования в книге задач укажите: theforeman.foreman.role.
Новый в версии 1.0.0: of theforeman.foreman
Описание
- Создание, обновление и удаление ролей
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- requests
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| description строка | Описание роли | ||
| filters список / элементы=словарь | Фильтры с разрешениями для этой роли | ||
| permissions список / элементы=строка / обязательно | Список разрешений | ||
| search строка | Условие фильтрации для ресурсов | ||
| locations список / элементы=строка | Список местоположений, которым должна быть назначена сущность | ||
| name строка / обязательно | Имя роли | ||
| organizations список / элементы=строка | Список организаций, которым должна быть назначена сущность | ||
| password строка / обязательно | Пароль пользователя, обращающегося к серверу Foreman. Если значение не указано в задаче, используется значение переменной среды FOREMAN_PASSWORD. | ||
| server_url строка / обязательно | URL сервера Foreman. Если значение не указано в задаче, используется значение переменной среды FOREMAN_SERVER_URL. | ||
| state строка |
| Состояние сущности | |
| username строка / обязательно | Имя пользователя, обращающегося к серверу Foreman. Если значение не указано в задаче, используется значение переменной среды FOREMAN_USERNAME. | ||
| validate_certs булево |
| Требуется ли проверка сертификатов TLS сервера Foreman. Если значение не указано в задаче, используется значение переменной среды FOREMAN_VALIDATE_CERTS. | |
Примеры
- name: role
theforeman.foreman.role:
name: "Provisioner"
description: "Only provision on libvirt"
locations:
- "Uppsala"
organizations:
- "ACME"
filters:
- permissions:
- view_hosts
search: "owner_type = Usergroup and owner_id = 4"
server_url: "https://foreman.example.com"
username: "admin"
password: "changeme"
state: present
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| entity словарь | success | Конечное состояние затронутых сущностей, сгруппированных по их типу. | |
| roles список / элементы=словарь | success | Список ролей. | |
Авторы
- Christoffer Reijer (@ephracis) Basalt AB
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/theforeman/foreman/role_module.html
