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 complex		success	Список сведений об изображениях
	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.8/modules/one_image_facts_module.html