ec2_snapshot_copy — копирует снимок EC2 и возвращает новый идентификатор снимка.

Новая в версии 2.4.

Описание
Требования (к хосту, на котором выполняется модуль)
Параметры
Примеры
Возвращаемые значения
Примечания
- Статус

Описание

Копирует снимок EC2 из исходной области в целевую область.

Требования (к хосту, на котором выполняется модуль)

boto
boto3
python >= 2.6

Параметры

параметр	обязателен	по умолчанию	возможные значения	комментарии
aws_access_key	нет			Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. псевдонимы: ec2_access_key, access_key
aws_secret_key	нет			Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. псевдонимы: ec2_secret_key, secret_key
description	нет			Необязательная строка для описания назначения нового снимка.
ec2_url	нет			URL для подключения к EC2 или облаку Eucalyptus (по умолчанию модуль использует адреса EC2). Игнорируется для модулей, где область требуется. Должен быть указан для всех остальных модулей, если не используется регион. Если не задан, используется значение переменной окружения EC2_URL.
encrypted	нет			Нужно ли шифровать целевой снимок.
kms_key_id	нет			Идентификатор ключа KMS, используемый для шифрования снимка. Если не указан, по умолчанию используется мастер-ключ EBS (CMK) для этой учетной записи.
profile (добавлен в 1.6)	нет			Использует профиль boto. Работает только с boto >= 2.24.0.
region	нет			Область AWS для использования. Если не указана, используется значение переменной окружения AWS_REGION или EC2_REGION. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region псевдонимы: aws_region, ec2_region
security_token (добавлен в 1.6)	нет			Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token
source_region	да			Исходная область, из которой должен быть скопирован снимок.
source_snapshot_id	да			Идентификатор снимка в исходной области, который должен быть скопирован.
tags	нет			Словарь тегов для добавления к новому снимку; '{"key":"value"}' и '{"key":"value","key":"value"}'
validate_certs (добавлен в 1.5)	нет	да	да нет	При значении "нет", сертификаты SSL не будут проверяться для версий boto >= 2.6.0.
wait	нет	нет	да нет	Ожидать, пока скопированный снимок не перейдет в состояние 'Available', перед возвратом.

Примеры

# Basic Snapshot Copy
- ec2_snapshot_copy:
    source_region: eu-central-1
    region: eu-west-1
    source_snapshot_id: snap-xxxxxxx

# Copy Snapshot and wait until available
- ec2_snapshot_copy:
    source_region: eu-central-1
    region: eu-west-1
    source_snapshot_id: snap-xxxxxxx
    wait: yes
  register: snapshot_id

# Tagged Snapshot copy
- ec2_snapshot_copy:
    source_region: eu-central-1
    region: eu-west-1
    source_snapshot_id: snap-xxxxxxx
    tags:
        Name: Snapshot-Name

# Encrypted Snapshot copy
- ec2_snapshot_copy:
    source_region: eu-central-1
    region: eu-west-1
    source_snapshot_id: snap-xxxxxxx
    encrypted: yes

# Encrypted Snapshot copy with specified key
- ec2_snapshot_copy:
    source_region: eu-central-1
    region: eu-west-1
    source_snapshot_id: snap-xxxxxxx
    encrypted: yes
    kms_key_id: arn:aws:kms:eu-central-1:XXXXXXXXXXXX:key/746de6ea-50a4-4bcb-8fbc-e3b29f2d367b

Возвращаемые значения

Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для этого модуля:

название	описание	возвращается	тип	пример
snapshot_id	Идентификатор нового снимка	при успешном копировании снимка	строка	snap-e9095e8c

Примечания

Примечание

Если параметры не заданы в модуле, можно использовать следующие переменные окружения в порядке убывания приоритета AWS_URL или EC2_URL, AWS_ACCESS_KEY_ID или AWS_ACCESS_KEY или EC2_ACCESS_KEY, AWS_SECRET_ACCESS_KEY или AWS_SECRET_KEY или EC2_SECRET_KEY, AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN, AWS_REGION или EC2_REGION
Ansible использует конфигурационный файл boto (обычно ~/.boto), если учетные данные не предоставлены. См. http://boto.readthedocs.org/en/latest/boto_config_tut.html
AWS_REGION или EC2_REGION обычно используются для указания области AWS, когда это требуется, но это также можно настроить в конфигурационном файле boto

Статус

Этот модуль помечен как превью, что означает, что интерфейс не гарантируется обратной совместимостью.

Для помощи в разработке модулей, если вас это заинтересует, пожалуйста, ознакомьтесь с Информация о сообществе и участие, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/ec2_snapshot_copy_module.html