Модуль community.general.manageiq_tenant — Управление арендаторами в ManageIQ

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Чтобы установить ее, используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования. Подробнее см. Требования.

Чтобы использовать его в плейбуке, укажите: community.general.manageiq_tenant.

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

Описание

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

Требования

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

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

Параметры

Параметр	Комментарии
description строка / обязательный	Описание арендатора.
manageiq_connection словарь	Информация о конфигурации подключения к ManageIQ.
ca_cert псевдонимы: ca_bundle_path строка	Путь к файлу или каталогу с сертификатами CA.
password строка	Пароль ManageIQ. `MIQ_PASSWORD` переменная окружения, если задана. В противном случае, требуется, если не передан токен.
token строка	Токен ManageIQ. `MIQ_TOKEN` переменная окружения, если задана. В противном случае, требуется, если не передан имя пользователя или пароль.
url строка	URL среды ManageIQ. `MIQ_URL` переменная окружения, если задана. В противном случае, необходимо передать ее.
username строка	Имя пользователя ManageIQ. `MIQ_USERNAME` переменная окружения, если задана. В противном случае, требуется, если не передан токен.
validate_certs псевдонимы: verify_ssl булево	Должны ли проверяться сертификаты SSL для HTTPS-запросов. Варианты: `false` `true` ← (по умолчанию)
name строка / обязательный	Имя арендатора.
parent строка	Имя родительского арендатора. Если не указан и `parent_id` не указан, используется корневой арендатор.
parent_id целое число	Идентификатор родительского арендатора. Если не указан, используется корневой арендатор. Значение `parent_id` имеет приоритет над `parent` при указании.
quotas словарь	Квоты арендатора. Все параметры чувствительны к регистру. Допустимые атрибуты: `cpu_allocated` (int): используйте null для удаления квоты. `mem_allocated` (ГБ): используйте null для удаления квоты. `storage_allocated` (ГБ): используйте null для удаления квоты. `vms_allocated` (int): используйте null для удаления квоты. `templates_allocated` (int): используйте null для удаления квоты. По умолчанию: `{}`
state строка	absent - арендатор не должен существовать, present - арендатор должен существовать. Варианты: `"absent"` `"present"` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: отсутствует	Может работать в режиме `check_mode` и возвращать предсказание состояния изменения без модификации целевого объекта.
diff_mode	Поддержка: отсутствует	Возвратит подробности о том, что изменилось (или, возможно, что нужно изменить в `check_mode`), когда в режиме diff.

Примеры

- name: Update the root tenant in ManageIQ
  community.general.manageiq_tenant:
    name: 'My Company'
    description: 'My company name'
    manageiq_connection:
      url: 'http://127.0.0.1:3000'
      username: 'admin'
      password: 'smartvm'
      validate_certs: false  # only do this when you trust the network!

- name: Create a tenant in ManageIQ
  community.general.manageiq_tenant:
    name: 'Dep1'
    description: 'Manufacturing department'
    parent_id: 1
    manageiq_connection:
      url: 'http://127.0.0.1:3000'
      username: 'admin'
      password: 'smartvm'
      validate_certs: false  # only do this when you trust the network!

- name: Delete a tenant in ManageIQ
  community.general.manageiq_tenant:
    state: 'absent'
    name: 'Dep1'
    parent_id: 1
    manageiq_connection:
      url: 'http://127.0.0.1:3000'
      username: 'admin'
      password: 'smartvm'
      validate_certs: false  # only do this when you trust the network!

- name: Set tenant quota for cpu_allocated, mem_allocated, remove quota for vms_allocated
  community.general.manageiq_tenant:
    name: 'Dep1'
    parent_id: 1
    quotas:
      - cpu_allocated: 100
      - mem_allocated: 50
      - vms_allocated: null
    manageiq_connection:
      url: 'http://127.0.0.1:3000'
      username: 'admin'
      password: 'smartvm'
      validate_certs: false  # only do this when you trust the network!


- name: Delete a tenant in ManageIQ using a token
  community.general.manageiq_tenant:
    state: 'absent'
    name: 'Dep1'
    parent_id: 1
    manageiq_connection:
      url: 'http://127.0.0.1:3000'
      token: 'sometoken'
      validate_certs: false  # only do this when you trust the network!

Значения возврата

Общие значения возврата документированы здесь, следующие являются полями, уникальными для данного модуля:

Ключ	Описание
арендатор сложный	Арендатор. Возвращено: успех
описание строка	Описание арендатора Возвращено: успех
id целое число	Идентификатор арендатора Возвращено: успех
название строка	Имя арендатора Возвращено: успех
id_родителя целое число	Идентификатор родительского арендатора Возвращено: успех
квоты список / элементы=строка	Список квот арендатора Возвращено: успех Пример: `{"cpu_allocated": 100, "mem_allocated": 50}`

Авторы

Evert Mulder (@evertmulder)

Ссылки на коллекции

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/manageiq_tenant_module.html