gce_snapshot - Создание или удаление снимков для объёмов хранилища GCE

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

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

Описание

Управление снимками для виртуальных машин GCE. Этот модуль управляет снимками для объёмов хранилища виртуальной машины GCE. Если есть несколько дисков, каждый снимок будет дополнен именем диска.

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

python >= 2.6
apache-libcloud >= 0.19.0

Параметры

параметр	обязателен	по умолчанию	варианты	комментарии
credentials_file	да			Путь к файлу учетных данных, связанному с учётной записью сервиса
disks	нет	все		Список дисков, для которых следует создать снимки. Если не указан, все объемы будут засняты
instance_name	да			Виртуальная машина GCE, для которой необходимо создать снимок
project_id	да			Идентификатор проекта GCP, который необходимо использовать
service_account_email	да			Электронный адрес учётной записи сервиса GCP для проекта, в котором находится виртуальная машина
snapshot_name	нет			Имя снимка для управления
state	нет	present	present absent	Необходимо ли создать снимок или удалить его

Примеры

- name: Create gce snapshot
  gce_snapshot:
    instance_name: example-instance
    snapshot_name: example-snapshot
    state: present
    service_account_email: project_name@appspot.gserviceaccount.com
    credentials_file: /path/to/credentials
    project_id: project_name
  delegate_to: localhost

- name: Delete gce snapshot
  gce_snapshot:
    instance_name: example-instance
    snapshot_name: example-snapshot
    state: absent
    service_account_email: project_name@appspot.gserviceaccount.com
    credentials_file: /path/to/credentials
    project_id: project_name
  delegate_to: localhost

# This example creates snapshots for only two of the available disks as
# disk0-example-snapshot and disk1-example-snapshot
- name: Create snapshots of specific disks
  gce_snapshot:
    instance_name: example-instance
    snapshot_name: example-snapshot
    state: present
    disks:
      - disk0
      - disk1
    service_account_email: project_name@appspot.gserviceaccount.com
    credentials_file: /path/to/credentials
    project_id: project_name
  delegate_to: localhost

Значения возврата

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

название	описание	возвращается	тип	пример
snapshots_absent	Список снимков, которые уже отсутствовали (бездействующая операция)	Когда снимки уже отсутствовали	список	[disk0-example-snapshot, disk1-example-snapshot]
snapshots_created	Список вновь созданных снимков	При создании снимков	список	[disk0-example-snapshot, disk1-example-snapshot]
snapshots_deleted	Список удалённых снимков	При удалении снимков	список	[disk0-example-snapshot, disk1-example-snapshot]
snapshots_existing	Список снимков, которые уже существовали (бездействующая операция)	Когда снимки уже были присутствовали	список	[disk0-example-snapshot, disk1-example-snapshot]

Статус

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

Для получения помощи в разработке модулей, если у вас есть такие намерения, прочитайте Информацию о сообществе и вклад, Тестирование 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/gce_snapshot_module.html