Модуль community.aws.ec2_ami_copy — копирует AMI между регионами AWS и возвращает идентификатор нового образа

access_key

псевдонимы: aws_access_key_id, aws_access_key

строка

Идентификатор ключа доступа AWS.

Дополнительные сведения о токенах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys.

Также можно использовать переменные среды AWS_ACCESS_KEY_ID или AWS_ACCESS_KEY (в порядке убывания предпочтительности).

Параметры aws_access_key и profile являются взаимоисключающими.

Псевдоним aws_access_key_id добавлен в выпуске 5.1.0 для единообразия с AWS SDK botocore.

aws_ca_bundle

путь

Путь к пакету сертификатов CA, используемому для проверки SSL-сертификатов.

Также можно использовать переменную среды AWS_CA_BUNDLE.

aws_config

словарь

Словарь для изменения конфигурации botocore.

Описание параметров доступно в документации AWS: https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config.

debug_botocore_endpoint_logs

логическое значение

Использовать логгер botocore.endpoint для сбора уникальных (а не общих) вызовов API "resource:action", выполненных во время задачи, и записывать их набор в ключ resource_actions результатов задачи. Используйте callback aws_resource_action, чтобы вывести общий список вызовов, выполненных во время плейбука.

Также можно использовать переменную среды ANSIBLE_DEBUG_BOTOCORE_LOGS.

Варианты:

• false ← (по умолчанию)
• true

description

строка

Необязательная строка с описанием содержимого и назначения нового AMI.

По умолчанию: ""

encrypted

логическое значение

Следует ли шифровать целевые моментальные снимки скопированного AMI.

Варианты:

• false ← (по умолчанию)
• true

endpoint_url

псевдонимы: aws_endpoint_url

строка

URL для подключения вместо конечных точек AWS по умолчанию. Этот параметр можно использовать для подключения к другим совместимым с AWS сервисам, однако коллекции amazon.aws и community.aws тестируются только с AWS.

Также можно использовать переменную среды AWS_URL.

kms_key_id

строка

Идентификатор ключа KMS, используемого для шифрования образа. Если не указан, используется ключ EBS Customer Master Key (CMK) по умолчанию для вашей учетной записи.

name

строка

Имя нового копируемого AMI. (В версии 2.3 значением по умолчанию является default, в предыдущих версиях — null.)

По умолчанию: "default"

profile

псевдонимы: aws_profile

строка

Именованный профиль AWS для аутентификации.

Дополнительные сведения об именованных профилях см. в документации AWS: https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html.

Также можно использовать переменную среды AWS_PROFILE.

Параметр profile взаимоисключающий с параметрами aws_access_key, aws_secret_key и session_token.

region

псевдонимы: aws_region

строка

Используемый регион AWS.

Для глобальных сервисов, таких как IAM, Route53 и CloudFront, параметр region игнорируется.

Также можно использовать переменную среды AWS_REGION.

Дополнительные сведения см. в документации Amazon AWS: http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region.

secret_key

псевдонимы: aws_secret_access_key, aws_secret_key

строка

Секретный ключ доступа AWS.

Дополнительные сведения о токенах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys.

Также можно использовать переменные среды AWS_SECRET_ACCESS_KEY или AWS_SECRET_KEY (в порядке убывания предпочтительности).

Параметры secret_key и profile являются взаимоисключающими.

Псевдоним aws_secret_access_key добавлен в выпуске 5.1.0 для единообразия с AWS SDK botocore.

session_token

псевдонимы: aws_session_token

строка

Токен сеанса AWS STS для использования с временными учетными данными.

Дополнительные сведения о токенах доступа см. в документации AWS: https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys.

Также можно использовать переменную среды AWS_SESSION_TOKEN.

Параметры session_token и profile являются взаимоисключающими.

source_image_id

строка / обязательный

Идентификатор AMI в исходном регионе, который необходимо скопировать.

source_region

строка / обязательный

Исходный регион, из которого необходимо скопировать AMI.

tag_equality

логическое значение

Использовать ли теги, если исходный AMI уже существует в целевом регионе. Если параметр включен и все теги существующего AMI совпадают, повторное копирование AMI не выполняется.

Варианты:

• false ← (по умолчанию)
• true

tags

псевдонимы: resource_tags

словарь

Хеш/словарь тегов, которые нужно добавить к новой копии AMI: {"key":"value"} и {"key":"value","key":"value"}

validate_certs

логическое значение

Если задано значение false, SSL-сертификаты при взаимодействии с API AWS проверяться не будут.

Настоятельно не рекомендуется задавать validate_certs=false; вместо этого рассмотрите возможность указать aws_ca_bundle.

Варианты:

• false
• true ← (по умолчанию)

wait

логическое значение

Ожидать перехода скопированного AMI в состояние available перед возвратом.

Варианты:

• false ← (по умолчанию)
• true

wait_timeout

целое число

Время ожидания в секундах, по истечении которого ожидание прекращается.

До версии 2.3 значением по умолчанию было 1200.

В версиях 2.3–2.5 этот параметр был объявлен устаревшим в пользу значений по умолчанию для waiter в boto3.

В версии 2.6 параметр был повторно включен, чтобы разрешить тайм-ауты длительностью более 10 минут.

По умолчанию: 600

image_id

строка

Идентификатор скопированного AMI

Возвращается: всегда

Пример: "ami-e689729e"