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. Более подробную информацию см. в разделе Поддержка и техническое обслуживание модулей.
Список других модулей, которые также поддерживаются сообществом 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.6/modules/gce_snapshot_module.html
