community.general.proxmox_group_info – Получение информации об одной или нескольких группах Proxmox VE
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/proxmox_group_info_module.html