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

Примечание

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

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

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

Чтобы использовать его в книге задач, укажите: community.general.manageiq_user.

Обзор
Требования
Параметры
Атрибуты
Примеры

Обзор

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

Требования

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

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

Параметры

Параметр	Комментарии
email строка	Электронный адрес пользователя.
group строка	Имя группы, к которой принадлежит пользователь.
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 строка	Полное имя пользователя.
password строка	Пароль пользователя.
state строка	absent - пользователь не должен существовать, present - пользователь должен быть. Варианты: `"absent"` `"present"` ← (по умолчанию)
update_password строка	`always` — обновит пароли безусловно. `on_create` — установит пароль только для вновь созданного пользователя. Варианты: `"always"` ← (по умолчанию) `"on_create"`
userid строка / обязательный	Уникальный идентификатор пользователя в ManageIQ, часто упоминается как имя пользователя.

Атрибуты

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

Примеры

- name: Create a new user in ManageIQ
  community.general.manageiq_user:
    userid: 'jdoe'
    name: 'Jane Doe'
    password: 'VerySecret'
    group: 'EvmGroup-user'
    email: 'jdoe@example.com'
    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 new user in ManageIQ using a token
  community.general.manageiq_user:
    userid: 'jdoe'
    name: 'Jane Doe'
    password: 'VerySecret'
    group: 'EvmGroup-user'
    email: 'jdoe@example.com'
    manageiq_connection:
      url: 'http://127.0.0.1:3000'
      token: 'sometoken'
      validate_certs: false  # only do this when you trust the network!

- name: Delete a user in ManageIQ
  community.general.manageiq_user:
    state: 'absent'
    userid: 'jdoe'
    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 user in ManageIQ using a token
  community.general.manageiq_user:
    state: 'absent'
    userid: 'jdoe'
    manageiq_connection:
      url: 'http://127.0.0.1:3000'
      token: 'sometoken'
      validate_certs: false  # only do this when you trust the network!

- name: Update email of user in ManageIQ
  community.general.manageiq_user:
    userid: 'jdoe'
    email: 'jaustine@example.com'
    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: Update email of user in ManageIQ using a token
  community.general.manageiq_user:
    userid: 'jdoe'
    email: 'jaustine@example.com'
    manageiq_connection:
      url: 'http://127.0.0.1:3000'
      token: 'sometoken'
      validate_certs: false  # only do this when you trust the network!

Авторы

Daniel Korn (@dkorn)

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

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