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

Примечание

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

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

Для использования в плейбуке укажите: community.general.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.general.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.general.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.general.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/general/gce_snapshot_module.html