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

Примечание

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

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

Атрибуты

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

Примеры

- 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:
    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!

Возвращаемые значения

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

Ключ	Описание
tenant complex	Арендатор. Возвращается: при успехе
description string	Описание арендатора. Возвращается: при успехе
id integer	Идентификатор арендатора. Возвращается: при успехе
name string	Имя арендатора. Возвращается: при успехе
parent_id integer	Идентификатор родительского арендатора. Возвращается: при успехе
quotas list / elements=string	Список квот арендатора. Возвращается: при успехе Пример: `{"cpu_allocated": 100, "mem_allocated": 50}`

Авторы

Evert Mulder (@evertmulder)

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

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