gce_snapshot – Создание или удаление снимков для томов хранилища GCE

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

Описание
Требования
Параметры
Примеры
Возвращаемые значения
Статус

Описание

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

Требования

Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.

python >= 2.6
apache-libcloud >= 0.19.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
credentials_file - / обязательно		Путь к файлу с учетными данными, связанным с учетной записью службы
disks -	Значение по умолчанию: "all"	Список дисков, для которых нужно создать снимки. Если список не задан, будут созданы снимки всех томов
instance_name - / обязательно		Экземпляр GCE, для которого нужно создать снимок
project_id - / обязательно		Идентификатор проекта GCP, который нужно использовать
service_account_email - / обязательно		Электронный адрес учетной записи службы GCP для проекта, в котором находится экземпляр
snapshot_name -		Имя снимка для управления
state -	Варианты: 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. [community]

Авторы

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.8/modules/gce_snapshot_module.html