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	Указывает, нужно ли создать снимок или удалить его.

Примеры

- 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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/google/gce_snapshot_module.html