vmware_guest_snapshot - Управление моментальными снимками виртуальных машин в vcenter

Новая в версии 2.3.

Обзор
Требования (для хоста, на котором выполняется модуль)
Параметры
Примеры
Возвращаемые значения
Примечания
- Статус

Обзор

Создание моментальных снимков виртуальных машин

Требования (для хоста, на котором выполняется модуль)

python >= 2.6
PyVmomi

Параметры

параметр	обязательно	по умолчанию	варианты	комментарии
datacenter	да			Целевой центр обработки данных для операции развертывания
описание	нет			Определяет произвольное описание, которое необходимо прикрепить к снимку.
папка	нет	/vm		Целевая папка, абсолютный или относительный путь для поиска существующего гостевого сервера. Требуется, если указано имя. Папка должна включать центр обработки данных. Центром обработки данных ESX является ha-datacenter Примеры: папка: /ha-datacenter/vm папка: ha-datacenter/vm папка: /datacenter1/vm папка: datacenter1/vm папка: /datacenter1/vm/folder1 папка: datacenter1/vm/folder1 папка: /folder1/datacenter1/vm папка: folder1/datacenter1/vm папка: /folder1/datacenter1/vm/folder2 папка: vm/folder2 папка: folder2
имя хоста	да			Имя хоста или IP-адрес vCenter vSphere.
memory_dump (добавлено в 2.4)	нет			Если установлено значение `true`, дамп памяти виртуальной машины также включен в снимок. Обратите внимание, что снимки памяти занимают время и ресурсы, для их создания потребуется больше времени. Если виртуальная машина не предоставляет возможность создания снимка памяти, этот флаг установлен в `false`.
имя	нет			Имя виртуальной машины для работы Требуется, если не указан uuid.
name_match	нет	first	first last	Если несколько виртуальных машин соответствуют имени, используется первая или последняя найденная
пароль	да			Пароль vCenter vSphere. псевдонимы: pass, pwd
quiesce (добавлено в 2.4)	нет			Если установлено значение `true`, и виртуальная машина включена, она приведет к приостановке файловой системы в виртуальной машине. Обратите внимание, что для этого флага необходимы VMware Tools. Если виртуальная машина выключена или VMware Tools недоступны, этот флаг установлен в `false`. Если виртуальная машина не предоставляет возможность создания снимка с приостановкой, этот флаг установлен в `false`.
remove_children (добавлено в 2.4)	нет			Если установлено значение `true`, и состояние установлено в `absent`, вся поддерево снимков устанавливается для удаления.
snapshot_name	нет			Устанавливает имя снимка для управления. Этот параметр необходим только если состояние не `remove_all`
состояние	да		present absent revert remove_all	Управление снимками, прикрепленными к определенной виртуальной машине.
имя пользователя	да			Имя пользователя vCenter vSphere. псевдонимы: user, admin
uuid	нет			UUID экземпляра для управления, если известен, это уникальный идентификатор VMware. Требуется, если не указано имя.
validate_certs	нет	True	True False	Разрешает подключение, когда сертификаты SSL недействительны. Установите значение false, когда сертификаты не доверенны.

Примеры

- name: Create snapshot
  vmware_guest_snapshot:
    hostname: 192.168.1.209
    username: administrator@vsphere.local
    password: vmware
    datacenter: datacenter_name
    folder: /myfolder
    name: dummy_vm
    state: present
    snapshot_name: snap1
    description: snap1_description
  delegate_to: localhost

- name: Remove a snapshot
  vmware_guest_snapshot:
    hostname: 192.168.1.209
    username: administrator@vsphere.local
    password: vmware
    name: dummy_vm
    datacenter: datacenter_name
    folder: /myfolder
    state: remove
    snapshot_name: snap1
  delegate_to: localhost

- name: Revert to a snapshot
  vmware_guest_snapshot:
    hostname: 192.168.1.209
    username: administrator@vsphere.local
    password: vmware
    datacenter: datacenter_name
    folder: /myfolder
    name: dummy_vm
    state: revert
    snapshot_name: snap1
  delegate_to: localhost

- name: Remove all snapshots of a VM
  vmware_guest_snapshot:
    hostname: 192.168.1.209
    username: administrator@vsphere.local
    password: vmware
    datacenter: datacenter_name
    folder: /myfolder
    name: dummy_vm
    state: remove_all
  delegate_to: localhost

- name: Take snapshot of a VM using quiesce and memory flag on
  vmware_guest_snapshot:
    hostname: 192.168.1.209
    username: administrator@vsphere.local
    password: vmware
    name: dummy_vm
    state: present
    snapshot_name: dummy_vm_snap_0001
    quiesce: True
    memory_dump: True
  delegate_to: localhost

- name: Remove a snapshot and snapshot subtree
  vmware_guest_snapshot:
    hostname: 192.168.1.209
    username: administrator@vsphere.local
    password: vmware
    name: dummy_vm
    state: remove
    remove_children: True
    snapshot_name: snap1
  delegate_to: localhost

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

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

имя	описание	возвращается	тип	пример
экземпляр	метаданные новой виртуальной машины	всегда	dict	None

Примечания

Примечание

Тестировалось на vSphere 5.5

Статус

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

Для получения помощи в разработке модулей, если вы захотите, прочитайте Справочную информацию сообщества и вклад, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/vmware_guest_snapshot_module.html