community.general.one_image_info – Сбор информации об изображениях OpenNebula
Примечание
Этот плагин входит в коллекцию community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.one_image_info.
Краткое описание
- Сбор информации об изображениях OpenNebula.
- Этот модуль назывался
one_image_factsдо Ansible 2.9. Использование не изменилось.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- pyone
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_password строка | Пароль пользователя для входа на сервер RPC OpenNebula. Если не задан, то используется значение переменной среды ONE_PASSWORD. | |
| api_url строка | URL сервера RPC OpenNebula. Рекомендуется использовать HTTPS, чтобы имя пользователя/пароль не передавались по сети без шифрования. Если не задан, то используется значение переменной среды ONE_URL. | |
| api_username строка | Имя пользователя для входа на сервер RPC OpenNebula. Если не задан, то используется значение переменной среды ONE_USERNAME. | |
| ids список / элементы=строка | Список идентификаторов изображений, чьи данные необходимо собрать. алиасы: id | |
| name строка | Имя изображения, чьи данные будут собраны. Если имя начинается с '~', то значение будет использоваться как шаблон регулярных выражений для фильтрации списка изображений (чьи данные будут возвращены) по совпадению с указанным шаблоном. Также, если имя начинается с '~*', будет производиться нечувствительное к регистру соответствие. См. примеры для получения дополнительной информации. |
Примеры
- name: Gather facts about all images
community.general.one_image_info:
register: result
- name: Print all images facts
ansible.builtin.debug:
msg: result
- name: Gather facts about an image using ID
community.general.one_image_info:
ids:
- 123
- name: Gather facts about an image using the name
community.general.one_image_info:
name: 'foo-image'
register: foo_image
- name: Gather facts about all IMAGEs whose name matches regex 'app-image-.*'
community.general.one_image_info:
name: '~app-image-.*'
register: app_images
- name: Gather facts about all IMAGEs whose name matches regex 'foo-image-.*' ignoring cases
community.general.one_image_info:
name: '~*foo-image-.*'
register: foo_images
Возвращаемые значения
Общие возвращаемые значения описаны в этом разделе, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| images сложный | успех | Список с информацией об изображениях | |
| group_id целое число | успех | Идентификатор группы изображения Пример: 1 | |
| group_name строка | успех | Название группы изображения Пример: one-users | |
| id целое число | успех | Идентификатор изображения Пример: 153 | |
| name строка | успех | Название изображения Пример: app1 | |
| owner_id целое число | успех | Идентификатор владельца изображения Пример: 143 | |
| owner_name строка | успех | Имя владельца изображения Пример: ansible-test | |
| running_vms целое число | успех | Количество работающих виртуальных машин, использующих это изображение Пример: 7 | |
| state строка | успех | Состояние экземпляра изображения Пример: READY | |
| used булево | успех | Используется ли изображение Пример: True | |
Авторы
- Milan Ilic (@ilicmilan)
- Jan Meerkamp (@meerkampdvv)
© 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/one_image_info_module.html
