manageiq_group – Управление группами в ManageIQ
Новое в версии 2.8.
Обзор
- Модуль manageiq_group поддерживает добавление, обновление и удаление групп в ManageIQ.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- manageiq-client https://github.com/ManageIQ/manageiq-api-client-python/
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| belongsto_filters список | Значение по умолчанию: null | Список строк с ссылкой на разрешённые хосты, кластеры или папки | |
| belongsto_filters_merge_mode - |
| В режиме merge существующие настройки объединяются с предоставленными belongsto_filters. В режиме replace текущие значения заменяются на предоставленные belongsto_filters. | |
| description - / обязательно | Значение по умолчанию: null | Описание группы. | |
| managed_filters словарь | Значение по умолчанию: null | Значения тегов по категориям | |
| managed_filters_merge_mode - |
| В режиме merge сохраняются или обновляются существующие категории, добавляются новые. В режиме replace все категории заменяются на предоставленные managed_filters. | |
| manageiq_connection словарь / обязательно | Информация о конфигурации подключения ManageIQ. | ||
| ca_cert путь | Путь к файлу или папке с сертификатами CA. По умолчанию None. псевдонимы: ca_bundle_path | ||
| password строка | Пароль ManageIQ. MIQ_PASSWORD переменная окружения, если задана. В противном случае, требуется, если не передан токен. | ||
| token строка | Токен ManageIQ. MIQ_TOKEN переменная окружения, если задана. В противном случае, требуется, если не переданы имя пользователя или пароль. | ||
| url строка / обязательно | URL окружения ManageIQ. MIQ_URL переменная окружения, если задана. В противном случае, требуется передать. | ||
| username строка | Имя пользователя ManageIQ. MIQ_USERNAME переменная окружения, если задана. В противном случае, требуется, если не передан токен. | ||
| validate_certs логическое |
| Необходимо ли проверять SSL-сертификаты для запросов HTTPS. По умолчанию True. псевдонимы: verify_ssl | |
| role - | Значение по умолчанию: null | Имя роли группы Значение role_id имеет приоритет над role, если задано. | |
| role_id - | Значение по умолчанию: null | Идентификатор роли группы | |
| state - |
| absent - группа не должна существовать, present - группа должна существовать. | |
| tenant - | Значение по умолчанию: null | Домен для группы, определяемый по имени домена. Значение tenant_id имеет приоритет над tenant, если задано.Имена доменов чувствительны к регистру. | |
| tenant_id - | Значение по умолчанию: null | Домен для группы, определяемый по идентификатору домена. | |
Примеры
- name: Create a group in ManageIQ with the role EvmRole-user and tenant 'my_tenant'
manageiq_group:
description: 'MyGroup-user'
role: 'EvmRole-user'
tenant: 'my_tenant'
manageiq_connection:
url: 'https://manageiq_server'
username: 'admin'
password: 'smartvm'
validate_certs: False
- name: Create a group in ManageIQ with the role EvmRole-user and tenant with tenant_id 4
manageiq_group:
description: 'MyGroup-user'
role: 'EvmRole-user'
tenant_id: 4
manageiq_connection:
url: 'https://manageiq_server'
username: 'admin'
password: 'smartvm'
validate_certs: False
- name:
- Create or update a group in ManageIQ with the role EvmRole-user and tenant my_tenant.
- Apply 3 prov_max_cpu and 2 department tags to the group.
- Limit access to a cluster for the group.
manageiq_group:
description: 'MyGroup-user'
role: 'EvmRole-user'
tenant: my_tenant
managed_filters:
prov_max_cpu:
- '1'
- '2'
- '4'
department:
- defense
- engineering
managed_filters_merge_mode: replace
belongsto_filters:
- "/belongsto/ExtManagementSystem|ProviderName/EmsFolder|Datacenters/EmsFolder|dc_name/EmsFolder|host/EmsCluster|Cluster name"
belongsto_filters_merge_mode: merge
manageiq_connection:
url: 'https://manageiq_server'
username: 'admin'
password: 'smartvm'
validate_certs: False
- name: Delete a group in ManageIQ
manageiq_group:
state: 'absent'
description: 'MyGroup-user'
manageiq_connection:
url: 'http://127.0.0.1:3000'
username: 'admin'
password: 'smartvm'
- name: Delete a group in ManageIQ using a token
manageiq_group:
state: 'absent'
description: 'MyGroup-user'
manageiq_connection:
url: 'http://127.0.0.1:3000'
token: 'sometoken'
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| group сложный | успех | Группа. | |
| belongsto_filters список | успех | Список строк с ссылкой на разрешённые хосты, кластеры или папки | |
| created_on строка | успех | Дата создания группы Пример: 2018-08-12T08:37:55+00:00 | |
| description строка | успех | Описание группы | |
| group_type строка | успех | Тип группы, системная или пользовательская | |
| id целое число | успех | Идентификатор группы | |
| managed_filters словарь | успех | Значения тегов по категориям | |
| role строка | успех | Имя роли группы | |
| tenant строка | успех | Имя домена группы | |
| updated_on целое число | успех | Дата обновления группы Пример: 2018-08-12T08:37:55+00:00 | |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Evert Mulder (@evertmulder)
Подсказка
Если вы обнаружите какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/manageiq_group_module.html