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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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 string	Адрес электронной почты пользователя.
group string	Название группы, к которой относится пользователь.
manageiq_connection dictionary	Сведения о конфигурации подключения к ManageIQ.
ca_cert псевдонимы: ca_bundle_path string	Путь к файлу пакета CA или каталогу с сертификатами.
password string	Пароль ManageIQ. Если задана переменная окружения `MIQ_PASSWORD`, используется её значение. В противном случае параметр обязателен, если не передан токен.
token string	Токен ManageIQ. Если задана переменная окружения `MIQ_TOKEN`, используется её значение. В противном случае параметр обязателен, если не переданы имя пользователя или пароль.
url string	URL среды ManageIQ. Если задана переменная окружения `MIQ_URL`, используется её значение. В противном случае параметр необходимо передать.
username string	Имя пользователя ManageIQ. Если задана переменная окружения `MIQ_USERNAME`, используется её значение. В противном случае параметр обязателен, если не передан токен.
validate_certs псевдонимы: verify_ssl boolean	Нужно ли проверять SSL-сертификаты для HTTPS-запросов. Варианты: `false` `true` ← (по умолчанию)
name string	Полное имя пользователя.
password string	Пароль пользователя.
state string	`absent` — пользователь не должен существовать, `present` — пользователь должен существовать. Варианты: `"absent"` `"present"` ← (по умолчанию)
update_password string	`always` безусловно обновляет пароли. `on_create` устанавливает пароль только для нового пользователя. Варианты: `"always"` ← (по умолчанию) `"on_create"`
userid string / обязательный	Уникальный идентификатор пользователя в ManageIQ, часто называемый именем пользователя.

Атрибуты

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

Примеры

- 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/general/manageiq_user_module.html