community.general.proxmox_group_info – Получение информации об одной или нескольких группах Proxmox VE

Примечание

Этот плагин входит в коллекцию community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: community.general.proxmox_group_info.

Введено в версии 1.3.0: коллекции community.general

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

Описание

Получение информации об одной или нескольких группах Proxmox VE

Требования

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

proxmoxer
requests

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_host строка / обязательно		Укажите целевой хост кластера Proxmox VE.
api_password строка		Укажите пароль для аутентификации. Можно использовать переменную среды `PROXMOX_PASSWORD`.
api_token_id строка добавлено в 1.3.0 community.general		Укажите идентификатор токена.
api_token_secret строка добавлено в 1.3.0 community.general		Укажите секрет токена.
api_user строка / обязательно		Укажите пользователя для аутентификации.
group строка		Ограничить результаты определенной группой. псевдонимы: groupid, name
validate_certs логическое значение	Варианты: нет ← да	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверяющих сертификатов.

Примеры

- name: List existing groups
  community.general.proxmox_group_info:
    api_host: helldorado
    api_user: root@pam
    api_password: "{{ password | default(omit) }}"
    api_token_id: "{{ token_id | default(omit) }}"
    api_token_secret: "{{ token_secret | default(omit) }}"
  register: proxmox_groups

- name: Retrieve information about the admin group
  community.general.proxmox_group_info:
    api_host: helldorado
    api_user: root@pam
    api_password: "{{ password | default(omit) }}"
    api_token_id: "{{ token_id | default(omit) }}"
    api_token_secret: "{{ token_secret | default(omit) }}"
    group: admin
  register: proxmox_group_admin

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

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

Ключ		Возвращаемое	Описание
proxmox_groups список / элементы=словарь		всегда, но может быть пустым	Список групп.
	comment строка	при успехе, может отсутствовать	Краткое описание группы.
	groupid строка	при успехе	Имя группы.
	users список / элементы=строка	при успехе	Список пользователей в группе.

Авторы

Tristan Le Guern (@Aversiste)

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