community.google.gce_snapshot – Создание или удаление снимков для объёмов хранения GCE

Примечание

Этот плагин входит в коллекцию community.google (версия 1.0.0).

Для его установки используйте: ansible-galaxy collection install community.google.

Для использования в книге задач укажите: community.google.gce_snapshot.

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

Обзор

Управляет снимками для экземпляров 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
  community.google.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
  community.google.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
  community.google.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]

Авторы

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.10/collections/community/google/gce_snapshot_module.html