Spec-Zone.ru › Ansible

Модуль community.general.manageiq_policies — управление профилями политик ресурсов в ManageIQ

Примечание

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

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

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

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

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

Краткое описание

  • Модуль manageiq_policies поддерживает добавление и удаление профилей политик (policy_profiles) в ManageIQ.

Требования

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

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

Параметры

Параметр

Комментарии

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 ← (по умолчанию)

policy_profiles

список / элементы=словарь

Список словарей, каждый из которых содержит ключ policy_profile name.

Обязателен, если state имеет значение present или absent.

resource_id

целое число

добавлено в community.general 2.2.0

Идентификатор ресурса, которому следует назначить профиль или отменить его назначение.

Необходимо указать, если не задан resource_name. Эти параметры взаимоисключающие.

resource_name

строка

Имя ресурса, которому следует назначить профиль или отменить его назначение.

Необходимо указать, если не задан resource_id. Эти параметры взаимоисключающие.

resource_type

строка / обязательный

Тип ресурса, которому следует назначить профиль или отменить его назначение.

Варианты:

  • "provider"
  • "host"
  • "vm"
  • "blueprint"
  • "category"
  • "cluster"
  • "data store"
  • "group"
  • "resource pool"
  • "service"
  • "service template"
  • "template"
  • "tenant"
  • "user"

state

строка

absent — профили политик (policy_profiles) не должны существовать,

present — профили политик (policy_profiles) должны существовать.

Варианты:

  • "absent"
  • "present" ← (по умолчанию)

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: нет

Может работать в режиме check_mode и возвращать прогноз статуса изменений, не изменяя целевой объект.

diff_mode

Поддержка: нет

В режиме различий показывает подробные сведения об изменениях (или о том, что, возможно, потребуется изменить в check_mode).

Примеры

- name: Assign new policy_profile for a provider in ManageIQ
  community.general.manageiq_policies:
    resource_name: 'EngLab'
    resource_type: 'provider'
    policy_profiles:
      - name: openscap profile
    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: Unassign a policy_profile for a provider in ManageIQ
  community.general.manageiq_policies:
    state: absent
    resource_name: 'EngLab'
    resource_type: 'provider'
    policy_profiles:
      - name: openscap profile
    manageiq_connection:
      url: 'http://127.0.0.1:3000'
      username: 'admin'
      password: 'smartvm'
      validate_certs: false # only do this when you trust the network!

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

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

Ключ

Описание

manageiq_policies

словарь

Список текущего профиля политик (policy_profile) и политик для поставщика в ManageIQ.

Возвращается: всегда

Пример: {"changed": false, "profiles": [{"policies": [{"active": true, "description": "OpenSCAP", "name": "openscap policy"}, {"active": true, "description": "Analyse incoming container images", "name": "analyse incoming container images"}, {"active": true, "description": "Schedule compliance after smart state analysis", "name": "schedule compliance after smart state analysis"}], "profile_description": "OpenSCAP profile", "profile_name": "openscap profile"}]}

Авторы

  • Daniel Korn (@dkorn)

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

  • Отслеживание проблем
  • Репозиторий (исходный код)
  • Обратиться за помощью
  • Отправить отчёт об ошибке
  • Запросить новую функцию
  • Связь

© 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_policies_module.html

Spec-Zone.ru

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