gce_snapshot – Создание или удаление снимков для хранилищ GCE
Описание
- Управляет снимками для виртуальных машин 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
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.9/modules/gce_snapshot_module.html