one_image_facts - Сбор фактов об изображениях OpenNebula
Новое в версии 2.6.
Обзор
- Сбор фактов об изображениях OpenNebula
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python-oca
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_password | Пароль пользователя для входа в сервер RPC OpenNebula. Если не указано, то используется значение переменной среды ONE_PASSWORD. | |
| api_url | URL сервера RPC OpenNebula. Рекомендуется использовать HTTPS, чтобы имя пользователя/пароль не передавались по сети без шифрования. Если не указано, то используется значение переменной среды ONE_URL. | |
| api_username | Имя пользователя для входа на сервер RPC OpenNebula. Если не указано, то используется значение переменной среды ONE_USERNAME. | |
| ids | Список идентификаторов изображений, факты которых необходимо собрать. Псевдонимы: id | |
| name | Имя изображения, факты которого необходимо собрать. Если имя начинается с '~', то оно будет использовано как шаблон регулярного выражения, ограничивающего список изображений (чьи факты будут возвращены) по совпадению имён со указанным регулярным выражением. Также, если имя начинается с '~*', будет выполнено нечувствительное к регистру сопоставление. См. примеры для более подробной информации. |
Примеры
# Gather facts about all images
- one_image_facts:
register: result
# Print all images facts
- debug:
msg: result
# Gather facts about an image using ID
- one_image_facts:
ids:
- 123
# Gather facts about an image using the name
- one_image_facts:
name: 'foo-image'
register: foo_image
# Gather facts about all IMAGEs whose name matches regex 'app-image-.*'
- one_image_facts:
name: '~app-image-.*'
register: app_images
# Gather facts about all IMAGEs whose name matches regex 'foo-image-.*' ignoring cases
- one_image_facts:
name: '~*foo-image-.*'
register: foo_images
Возвращаемые значения
Общие возвращаемые значения описаны здесь, ниже приведены поля, уникальные для данного модуля:
| Ключ | Возвращённое значение | Описание | |
|---|---|---|---|
| images сложный тип | success | Список информации об изображениях | |
| id целое число | Идентификатор изображения Пример: 153 | ||
| name строка | Имя изображения Пример: app1 | ||
| group_id целое число | Идентификатор группы изображения Пример: 1 | ||
| group_name строка | Имя группы изображения Пример: one-users | ||
| owner_id целое число | Идентификатор владельца изображения Пример: 143 | ||
| owner_name строка | Имя владельца изображения Пример: ansible-test | ||
| state строка | Состояние экземпляра изображения Пример: READY | ||
| used булево значение | Используется ли изображение Пример: True | ||
| running_vms целое число | Количество запущенных ВМ, использующих это изображение Пример: 7 | ||
Статус
Этот модуль помечен как предварительный, что означает, что его интерфейс не гарантированно будет совместим со старыми версиями.
Обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в разделе Поддержка и обслуживание модулей.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- Milan Ilic (@ilicmilan)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/one_image_facts_module.html
