community.general.one_image – Управляет изображениями OpenNebula

Примечание

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

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

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

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

Обзор

Управление изображениями OpenNebula

Требования

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

python-oca

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_password строка		Пароль пользователя для входа в сервер RPC OpenNebula. Если не задано то используется значение переменной среды `ONE_PASSWORD`.
api_url строка		URL сервера RPC OpenNebula. Рекомендуется использовать HTTPS, чтобы имя пользователя/пароль не передавались по сети без шифрования. Если не задано, то используется значение переменной среды `ONE_URL`.
api_username строка		Имя пользователя для входа на сервер RPC OpenNebula. Если не задано то используется значение переменной среды `ONE_USERNAME`.
enabled булево	Варианты: no yes	Включить или отключить изображение.
id целое число		`id` управляемого изображения.
name строка		`name` управляемого изображения.
new_name строка		Имя, которое будет назначено существующему или новому изображению. В случае клонирования по умолчанию `new_name` примет имя исходного изображения с префиксом 'Копия '.
state строка	Варианты: present ← absent cloned renamed	`present` - состояние, используемое для управления изображением `absent` - удалить изображение `cloned` - клонировать изображение `renamed` - переименовать изображение на `new_name`

Примеры

- name: Fetch the IMAGE by id
  community.general.one_image:
    id: 45
  register: result

- name: Print the IMAGE properties
  ansible.builtin.debug:
    msg: result

- name: Rename existing IMAGE
  community.general.one_image:
    id: 34
    state: renamed
    new_name: bar-image

- name: Disable the IMAGE by id
  community.general.one_image:
    id: 37
    enabled: no

- name: Enable the IMAGE by name
  community.general.one_image:
    name: bar-image
    enabled: yes

- name: Clone the IMAGE by name
  community.general.one_image:
    name: bar-image
    state: cloned
    new_name: bar-image-clone
  register: result

- name: Delete the IMAGE by id
  community.general.one_image:
    id: '{{ result.id }}'
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
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)

© 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_module.html