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

Примеры

# 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 целое число	успех	идентификатор группы образа Пример: 1
group_name строка	успех	имя группы образа Пример: one-users
id целое число	успех	идентификатор образа Пример: 153
name строка	успех	имя образа Пример: app1
owner_id целое число	успех	идентификатор владельца образа Пример: 143
owner_name строка	успех	имя владельца образа Пример: ansible-test
running_vms целое число	успех	количество запущенных ВМ, использующих этот образ Пример: 7
state строка	успех	состояние экземпляра образа Пример: 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_module.html