one_image_info – Сбор информации об изображениях OpenNebula

Новая версия 2.6.

Описание
Требования
Параметры
Примеры
Возвращаемые значения
Статус

Описание

Сбор информации об изображениях OpenNebula.
Этот модуль назывался one_image_facts перед Ansible 2.9. Способ использования не изменился.

Псевдонимы: one_image_facts

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

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_info:
  register: result

# Print all images facts
- debug:
    msg: result

# Gather facts about an image using ID
- one_image_info:
    ids:
      - 123

# Gather facts about an image using the name
- one_image_info:
    name: 'foo-image'
  register: foo_image

# Gather facts about all IMAGEs whose name matches regex 'app-image-.*'
- one_image_info:
    name: '~app-image-.*'
  register: app_images

# Gather facts about all IMAGEs whose name matches regex 'foo-image-.*' ignoring cases
- one_image_info:
    name: '~*foo-image-.*'
  register: foo_images

Возвращаемые значения

Общие возвращаемые значения описаны здесь, ниже приведены поля, уникальные для данного модуля:

Ключ		Возвращаемое	Описание
images complex		success	Список информации об изображениях
	group_id integer		Идентификатор группы изображения Пример: 1
	group_name string		Имя группы изображения Пример: one-users
	id integer		Идентификатор изображения Пример: 153
	name string		Имя изображения Пример: app1
	owner_id integer		Идентификатор владельца изображения Пример: 143
	owner_name string		Имя владельца изображения Пример: ansible-test
	running_vms integer		Количество запущенных ВМ, использующих это изображение Пример: 7
	state string		Состояние экземпляра изображения Пример: READY
	used boolean		Используется ли изображение Пример: True

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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.9/modules/one_image_info_module.html