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 |
| Включить или отключить изображение. |
| id - | Идентификатор изображения, которое требуется обработать. | |
| name - | Имя изображения, которое требуется обработать. | |
| new_name - | Имя, которое будет назначено существующему или новому изображению. В случае клонирования по умолчанию new_name получит имя исходного изображения с префиксом 'Копия'. | |
| state - |
| 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.7/modules/one_image_module.html