community.general.manageiq_group – Управление группами в ManageIQ.

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: community.general.manageiq_group.

Обзор
Требования
Параметры
Примеры
Возвращаемые значения

Обзор

Модуль manageiq_group поддерживает добавление, обновление и удаление групп в ManageIQ.

Требования

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

manageiq-client
manageiq-client https://github.com/ManageIQ/manageiq-api-client-python/

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
belongsto_filters список / элементы=строка			Список строк со ссылкой на разрешенные хосты, кластеры или папки
belongsto_filters_merge_mode строка		Варианты: merge replace ←	В режиме merge существующие настройки объединяются с предоставленными `belongsto_filters`. В режиме replace текущие значения заменяются на предоставленные `belongsto_filters`.
description строка / обязательно			Описание группы.
managed_filters словарь			Значения тегов по категориям
managed_filters_merge_mode строка		Варианты: merge replace ←	В режиме 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 логическое	Варианты: no yes ←	Должны ли проверяться SSL-сертификаты для HTTPS-запросов. По умолчанию True. алиасы: verify_ssl
role строка			Имя роли группы. Значение `role_id` имеет приоритет над `role`, если оно задано.
role_id целое число			Идентификатор роли группы.
state строка		Варианты: absent present ←	absent - группа не должна существовать, present - группа должна существовать.
tenant строка			Субъект для группы, определяемой именем субъекта. Значение `tenant_id` имеет приоритет над `tenant`, если оно задано. Имена субъектов чувствительны к регистру.
tenant_id целое число			Субъект для группы, определяемой идентификатором субъекта.

Примеры

- name: Create a group in ManageIQ with the role EvmRole-user and tenant 'my_tenant'
  community.general.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
  community.general.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.
  community.general.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
  community.general.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
  community.general.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 строка	успех	Тип группы, system или user
	id целое число	успех	Идентификатор группы
	managed_filters словарь	успех	Значения тегов по категориям
	role строка	успех	Имя роли группы
	tenant строка	успех	Имя субъекта группы
	updated_on целое число	успех	Дата обновления группы Пример: 2018-08-12T08:37:55+00:00

Авторы

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.10/collections/community/general/manageiq_group_module.html