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	Определяет, должен ли `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. [сообщество]

Авторы

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