community.general.one_image_facts – Сбор информации об изображениях OpenNebula

Примечание

Этот плагин является частью коллекции community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: community.general.one_image_facts.

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

Обзор

Сбор информации об изображениях 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_facts_module.html