Spec-Zone.ru › Ansible 2.9

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

Новое в версии 2.8.

  • Описание
  • Требования
  • Параметры
  • Примеры
  • Возвращаемые значения
  • Статус

Описание

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

Требования

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

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

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
belongsto_filters
список
Значение по умолчанию:
null
Список строк со ссылкой на разрешенные хосты, кластеры или папки
belongsto_filters_merge_mode
-
    Варианты:
  • merge
  • replace ←
В режиме merge существующие настройки объединяются с предоставленными belongsto_filters.
В режиме replace текущие значения заменяются предоставленными belongsto_filters.
description
- / обязательно
Значение по умолчанию:
null
Описание группы.
managed_filters
словарь
Значение по умолчанию:
null
Значения тегов по категориям
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
-
Значение по умолчанию:
null
Имя роли группы
Значение role_id имеет приоритет над role, если оно предоставлено.
role_id
-
Значение по умолчанию:
null
Идентификатор роли группы
state
-
    Варианты:
  • absent
  • present ←
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.9/modules/manageiq_group_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API