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

Примечание

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

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

Чтобы использовать его в playbook, укажите: 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/manageiq_group_module.html