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 ← absent	Нужно ли `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-пример-снимок, disk1-пример-снимок]
snapshots_created список	При создании снимков	Список вновь созданных снимков Пример: [disk0-пример-снимок, disk1-пример-снимок]
snapshots_deleted список	При удалении снимков	Список удаленных снимков Пример: [disk0-пример-снимок, disk1-пример-снимок]
snapshots_existing список	При наличии снимков	Список снимков, которые уже существовали (без действия) Пример: [disk0-пример-снимок, disk1-пример-снимок]

Статус

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

Автор

Rob Wagner (@robwagner33)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

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