one_image - Управляет образами 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`.
enabled bool	Варианты: no yes	Включить или отключить образ.
id		Идентификатор образа, который требуется управлять.
name		Имя образа, который требуется управлять.
new_name		Имя, которое будет присвоено существующему или новому образу. В случае клонирования, по умолчанию `new_name` получит имя исходного образа с префиксом 'Копия от'.
state	Варианты: present ← absent cloned renamed	`present` - состояние, используемое для управления образом `cloned` - клонировать образ `renamed` - переименовать образ на `new_name` `absent` - удалить образ

Примеры

# Fetch the IMAGE by id
- one_image:
    id: 45
  register: result

# Print the IMAGE properties
- debug:
    msg: result

# Rename existing IMAGE
- one_image:
    id: 34
    state: renamed
    new_name: bar-image

# Disable the IMAGE by id
- one_image:
    id: 37
    enabled: no

# Enable the IMAGE by name
- one_image:
    name: bar-image
    enabled: yes

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

# Delete the IMAGE by id
- one_image:
    id: '{{ result.id }}'
    state: absent

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

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

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

Статус

Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость.

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Поддержка и техническое обслуживание модулей для получения дополнительной информации.

Список других модулей, которые также поддерживаются сообществом 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.6/modules/one_image_module.html