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
сложный |
успех |
Список сведений об изображениях
|
|
| 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
|
||
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом 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.7/modules/one_image_facts_module.html
