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

Примечание

Этот плагин входит в состав коллекции community.general (версия 2.0.1).

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

Для использования в playbook укажите: community.general.one_image_info

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

Обзор

Сбор информации об изображениях 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` начинается с '~', то `name` будет использоваться как шаблон регулярного выражения, что сузит список изображений (чьи факты будут возвращены), имена которых соответствуют заданному регулярному выражению. Также, если имя `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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/one_image_info_module.html