Spec-Zone.ru › Ansible

Модуль amazon.aws.ec2_launch_template — управление шаблонами запуска EC2

Примечание

Этот модуль входит в коллекцию amazon.aws (версия 11.3.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install amazon.aws. Для использования этого модуля требуются дополнительные компоненты; подробную информацию см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: amazon.aws.ec2_launch_template.

Добавлено в community.aws 1.0.0

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Создание, изменение и удаление шаблонов запуска EC2, которые можно использовать для создания отдельных экземпляров или вместе с группами автоматического масштабирования.
  • Вместо указания всех параметров непосредственно в задачах модулям amazon.aws.ec2_instance и community.aws.autoscaling_group можно передать шаблон запуска, содержащий такие настройки, как размер экземпляра, тип диска, подсеть и другие.

Требования

Следующие требования должны быть выполнены на хосте, на котором запускается этот модуль.

  • python >= 3.6
  • boto3 >= 1.35.0
  • botocore >= 1.35.0

Параметры

Параметр

Комментарии

access_key

aliases: aws_access_key_id, aws_access_key

string

Идентификатор ключа доступа 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 для согласованности с SDK AWS botocore.

aws_ca_bundle

path

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

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

aws_config

dictionary

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

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

block_device_mappings

list / elements=dictionary

Сопоставление блочных устройств. Если в качестве аргументов сопоставления блочных устройств указать и идентификатор снимка, и значение шифрования, возникнет ошибка. Это связано с тем, что при запуске можно зашифровать только пустые тома, которые не создаются из снимка. Если том создается на основе снимка, он по определению содержит данные, и изменить состояние его шифрования с помощью этого действия нельзя.

device_name

string

Имя устройства (например, /dev/sdh или xvdh).

ebs

dictionary

Параметры автоматической настройки томов EBS при запуске экземпляра.

delete_on_termination

boolean

Указывает, удаляется ли том EBS при завершении работы экземпляра.

Варианты:

  • false
  • true

encrypted

boolean

Указывает, зашифрован ли том EBS. Зашифрованные тома можно подключать только к экземплярам, поддерживающим шифрование Amazon EBS. Если том создается из снимка, указать значение шифрования нельзя.

Варианты:

  • false
  • true

iops

integer

Количество операций ввода-вывода в секунду (IOPS), поддерживаемое томом. Для io1 это количество IOPS, выделенное для тома. Для gp2 это базовая производительность тома и скорость накопления кредитов ввода-вывода для увеличения производительности. Дополнительные сведения о базовой производительности SSD общего назначения, кредитах ввода-вывода и увеличении производительности см. в разделе «Типы томов Amazon EBS» руководства пользователя Amazon Elastic Compute Cloud.

Условие: этот параметр обязателен для запросов на создание томов io1; он не используется в запросах на создание томов gp2, st1, sc1 или standard.

kms_key_id

string

ARN главного ключа AWS Key Management Service (AWS KMS) CMK, используемого для шифрования.

snapshot_id

string

Идентификатор снимка, на основе которого создается том.

throughput

integer

добавлено в amazon.aws 9.0.0

Пропускная способность, выделяемая для тома gp3, не более 2 000 МиБ/с. Допустимый диапазон: минимальное значение 125. Максимальное значение 2000.

volume_size

integer

Размер тома в ГиБ.

По умолчанию: если том создается из снимка и размер тома не указан, используется размер снимка.

volume_type

string

Тип тома

no_device

string

Исключает указанное устройство, включенное в сопоставление блочных устройств AMI.

virtual_name

string

Имя виртуального устройства (ephemeralN). Нумерация томов хранилища экземпляра начинается с 0. Для типа экземпляра с двумя доступными томами хранилища экземпляра можно указать сопоставления для ephemeral0 и ephemeral1. Число доступных томов хранилища экземпляра зависит от типа экземпляра. После подключения к экземпляру необходимо смонтировать том.

cpu_options

dictionary

Выберите параметры ЦП для экземпляров EC2, создаваемых с помощью этого шаблона.

Дополнительные сведения см. на странице http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-optimize-cpu.html

core_count

integer

Количество ядер ЦП экземпляра.

threads_per_core

integer

Количество потоков на ядро ЦП. Чтобы отключить технологию Intel Hyper-Threading для экземпляра, укажите значение 1. В противном случае укажите значение по умолчанию 2.

credit_specification

dictionary

Параметр кредитов для использования ЦП экземпляром. Применимо только к экземплярам T2 и T3.

cpu_credits

string

Параметр кредитов для использования ЦП экземпляром T2 или T3. Допустимые значения: standard и unlimited.

debug_botocore_endpoint_logs

boolean

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

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

Варианты:

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

default_version

string

Какая версия должна использоваться по умолчанию при запуске новых экземпляров на основе этого шаблона? По умолчанию версией по умолчанию становится последняя версия.

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

disable_api_termination

boolean

Защищает экземпляры от случайного завершения работы.

Если задано значение true, завершить работу экземпляра с помощью консоли, CLI или API Amazon EC2 нельзя.

Варианты:

  • false
  • true

ebs_optimized

boolean

Указывает, оптимизирован ли экземпляр для операций ввода-вывода Amazon EBS. Такая оптимизация обеспечивает выделенную пропускную способность для Amazon EBS и оптимизированный стек конфигурации, обеспечивающий оптимальную производительность ввода-вывода Amazon EBS. Эта оптимизация доступна не для всех типов экземпляров. При использовании экземпляра, оптимизированного для EBS, взимается дополнительная плата.

Варианты:

  • false
  • true

elastic_gpu_specifications

list / elements=dictionary

Параметры подключения Elastic GPU. Подробности см. на странице https://aws.amazon.com/ec2/elastic-gpus/.

type

string

Тип подключаемого Elastic GPU

endpoint_url

aliases: aws_endpoint_url

string

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

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

iam_instance_profile

string

Имя или ARN профиля экземпляра IAM. Требуются разрешения на просмотр существующих ролей экземпляров, чтобы проверить правильность формата ARN.

image_id

string

Идентификатор AMI для новых экземпляров, запускаемых с помощью этого шаблона. Значение зависит от региона, поскольку AMI не являются глобальными ресурсами.

instance_initiated_shutdown_behavior

string

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

Варианты:

  • "stop"
  • "terminate"

instance_market_options

dictionary

Параметры альтернативных рынков экземпляров; в настоящее время поддерживается только рынок Spot.

market_type

string

Тип рынка. Всегда должно быть указано spot.

spot_options

dictionary

Параметры, специфичные для рынка Spot.

block_duration_minutes

integer

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

Это значение должно быть кратно 60 (60, 120, 180, 240, 300 или 360).

instance_interruption_behavior

string

Поведение при прерывании работы экземпляра Spot. По умолчанию используется terminate.

Варианты:

  • "hibernate"
  • "stop"
  • "terminate"

max_price

string

Максимальная почасовая цена, которую вы готовы заплатить за этот экземпляр Spot.

spot_instance_type

string

Тип отправляемого запроса.

Варианты:

  • "one-time"
  • "persistent"

instance_type

string

Тип экземпляра, например c5.2xlarge. Полный список типов экземпляров см. на странице http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/instance-types.html.

kernel_id

string

Идентификатор ядра.

Рекомендуется использовать PV-GRUB вместо ядер и RAM-дисков. Дополнительные сведения см. на странице http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html

key_name

string

Имя пары ключей. Создать пару ключей можно с помощью amazon.aws.ec2_key.

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

metadata_options

dictionary

добавлено в amazon.aws 1.5.0

Настройка параметров метаданных EC2.

Дополнительные сведения см. в документации IMDS: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html.

http_endpoint

string

Этот параметр включает или отключает конечную точку метаданных HTTP на ваших экземплярах.

Варианты:

  • "enabled" ← (по умолчанию)
  • "disabled"

http_protocol_ipv6

string

добавлено в amazon.aws 3.1.0

Доступна ли конечная точка метаданных экземпляра через IPv6.

Варианты:

  • "enabled"
  • "disabled" ← (по умолчанию)

http_put_response_hop_limit

integer

Требуемое ограничение числа переходов для HTTP PUT-ответа на запросы метаданных экземпляра.

Чем больше значение, тем дальше могут передаваться запросы метаданных экземпляра.

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

http_tokens

string

Состояние использования токенов в запросах метаданных экземпляра.

Варианты:

  • "optional" ← (по умолчанию)
  • "required"

instance_metadata_tags

string

добавлено в amazon.aws 3.1.0

Доступны ли теги экземпляра (enabled) через конечную точку метаданных или нет (disabled).

Варианты:

  • "enabled"
  • "disabled" ← (по умолчанию)

monitoring

dictionary

Параметры мониторинга экземпляра.

enabled

boolean

Включать ли подробный мониторинг для новых экземпляров. За него взимается дополнительная плата.

Варианты:

  • false
  • true

network_interfaces

list / elements=dictionary

Один или несколько сетевых интерфейсов.

associate_public_ip_address

boolean

Назначает общедоступный адрес IPv4 интерфейсу eth0 нового сетевого интерфейса.

Варианты:

  • false
  • true

delete_on_termination

boolean

Указывает, удаляется ли сетевой интерфейс при завершении работы экземпляра.

Варианты:

  • false
  • true

description

string

Описание сетевого интерфейса.

device_index

integer

Индекс устройства для подключения сетевого интерфейса.

groups

list / elements=string

Список идентификаторов групп безопасности, которые нужно назначить этому экземпляру.

ipv6_address_count

integer

Количество адресов IPv6, назначаемых сетевому интерфейсу.

Amazon EC2 автоматически выбирает адреса IPv6 из диапазона подсети.

Эту опцию нельзя использовать, если указана опция network_interfaces.ipv6_addresses.

ipv6_addresses

list / elements=string

Список из одного или нескольких определённых адресов IPv6 из диапазона блока CIDR IPv6 вашей подсети.

Эту опцию нельзя использовать, если указана опция network_interfaces.ipv6_address_count.

network_interface_id

string

Идентификатор eni сетевого интерфейса для подключения.

private_ip_address

string

Основной частный адрес IPv4 сетевого интерфейса.

subnet_id

string

Идентификатор подсети для сетевого интерфейса.

placement

dictionary

Параметры группы размещения экземпляра.

affinity

string

Настройка affinity для экземпляра на выделенном хосте.

availability_zone

string

Зона доступности для экземпляра.

group_name

string

Имя группы размещения экземпляра.

host_id

string

Идентификатор выделенного хоста для экземпляра.

tenancy

string

Тип размещения экземпляра (если экземпляр запущен в VPC). Экземпляр с типом размещения dedicated работает на оборудовании, предназначенном для одного клиента.

profile

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

string

Именованный профиль 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.

purge_tags

boolean

Если purge_tags=true и задан параметр tags, существующие теги будут удалены из ресурса, чтобы его теги точно соответствовали определённым параметром tags.

Если параметр tags не задан, теги не будут изменены, даже если purge_tags=True.

Ключи тегов, начинающиеся с aws:, зарезервированы Amazon и не могут быть изменены. Поэтому при обработке параметра purge_tags они будут игнорироваться. Дополнительную информацию см. в документации Amazon https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html#tag-conventions.

Варианты:

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

ram_disk_id

string

Идентификатор RAM-диска, с которым запускается экземпляр. Рекомендуется использовать PV-GRUB вместо ядер и RAM-дисков. Дополнительную информацию см. по ссылке http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/UserProvidedkernels.html

region

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

string

Регион 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

string

Секретный ключ доступа 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.

security_group_ids

list / elements=string

Список идентификаторов групп безопасности (VPC или EC2-Classic), в которые будут добавлены новые экземпляры.

security_groups

list / elements=string

Список имён групп безопасности (Default VPC или EC2-Classic), в которые будут добавлены новые экземпляры. Для любой VPC, кроме Default, необходимо использовать security_group_ids.

session_token

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

string

Токен сеанса 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_version

string

добавлено в amazon.aws 4.1.0

Номер версии шаблона запуска, на основе которой создаётся новая версия.

Новая версия наследует параметры запуска исходной версии, за исключением параметров, указанных явно.

Снимки, применённые к block_device_mappings, игнорируются при создании новой версии, если они не включены явно.

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

state

string

Должен ли шаблон запуска существовать.

Удаление отдельных версий шаблона запуска в настоящее время не поддерживается.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

tag_specifications

list / elements=dictionary

добавлено в amazon.aws 9.0.0

Теги, применяемые к ресурсам при использовании этого шаблона запуска.

resource_type

string

Тип ресурса, которому назначается тег.

Если экземпляр не включает указанный тип ресурса, запуск экземпляра завершится ошибкой.

Варианты:

  • "instance" ← (по умолчанию)
  • "volume"
  • "network-interface"
  • "spot-instances-request"

tags

dictionary

Набор пар «ключ-значение», применяемых к типу ресурса.

Ограничения для ключей тегов: ключи тегов чувствительны к регистру и могут содержать не более 127 символов Unicode. Не могут начинаться с aws:

Ограничения для значений тегов: значения тегов чувствительны к регистру и могут содержать не более 255 символов Unicode.

tags

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

dictionary

Словарь тегов, применяемых к ресурсу.

Если параметр tags не задан, теги не будут изменены.

template_id

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

string

Идентификатор шаблона запуска. Его можно использовать во всех случаях, кроме создания нового шаблона запуска.

Необходимо указать как минимум один из параметров template_id и template_name.

template_name

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

string

Имя шаблона. Оно должно быть уникальным в используемой комбинации региона и учётной записи.

Если шаблон запуска с указанным именем не существует, создаётся новый шаблон запуска.

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

Если шаблон запуска с указанным именем уже существует и конфигурация изменилась, создаётся новая версия шаблона запуска.

Необходимо указать как минимум один из параметров template_id и template_name.

user_data

string

Данные пользователя в кодировке Base64, предоставляемые экземпляру. Дополнительную информацию см. в документации по данным пользователя для Linux http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/user-data.html и Windows http://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/ec2-instance-metadata.html#instancedata-add-user-data.

validate_certs

boolean

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

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

Варианты:

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

version_description

string

добавлено в amazon.aws 5.5.0

Описание версии шаблона запуска.

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

versions_to_delete

list / elements=integer

добавлено в amazon.aws 9.0.0

Номера версий шаблона запуска для удаления.

Используйте default_version, чтобы указать новую версию по умолчанию при удалении текущей версии по умолчанию.

По умолчанию версией по умолчанию становится последняя версия.

Игнорируется, если state=present.

Примечания

Примечание

  • Используемая опция tags добавлена в выпуске 9.0.0 для применения к ресурсу шаблона запуска, а не к ресурсу шаблона запуска.
  • Используйте tag_specifications, чтобы задать теги, применяемые к ресурсам при использовании этого шаблона запуска.
  • Поддержка purge_tags добавлена в выпуске 9.0.0.
  • Внимание: Для модулей переменные окружения и файлы конфигурации считываются из контекста Ansible «host», а не из контекста «controller». Поэтому файлы может потребоваться явно скопировать на «host». Для плагинов поиска и подключений переменные окружения и файлы конфигурации считываются из контекста Ansible «controller», а не из контекста «host».
  • Используемый Ansible пакет AWS SDK (boto3) также может считывать настройки учётных данных и другие параметры, например регион, из файлов конфигурации в контексте Ansible «host» (обычно ~/.aws/credentials). Дополнительную информацию см. по ссылке https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html.

Примеры

- name: Create an ec2 launch template
  amazon.aws.ec2_launch_template:
    name: "my_template"
    image_id: "ami-04b762b4289fba92b"
    key_name: my_ssh_key
    instance_type: t2.micro
    iam_instance_profile: myTestProfile
    disable_api_termination: true

- name: >
    Create a new version of an existing ec2 launch template with a different instance type,
    while leaving an older version as the default version
  amazon.aws.ec2_launch_template:
    name: "my_template"
    default_version: 1
    instance_type: c5.4xlarge

- name: Delete an ec2 launch template
  amazon.aws.ec2_launch_template:
    name: "my_template"
    state: absent

- name: Delete a specific version of an ec2 launch template
  amazon.aws.ec2_launch_template:
    name: "my_template"
    versions_to_delete:
      - 2
    state: absent

- name: Delete a specific version of an ec2 launch template and change the default version
  amazon.aws.ec2_launch_template:
    name: "my_template"
    versions_to_delete:
      - 1
    default_version: 2
    state: absent

- name: Create an ec2 launch template with specific tags
  amazon.aws.ec2_launch_template:
    name: "my_template"
    image_id: "ami-04b762b4289fba92b"
    instance_type: t2.micro
    disable_api_termination: true
    tags:
      Some: tag
      Another: tag

- name: Create an ec2 launch template with different tag for volume and instance
  amazon.aws.ec2_launch_template:
    name: "my_template"
    image_id: "ami-04b762b4289fba92b"
    instance_type: t2.micro
    block_device_mappings:
      - device_name: /dev/sdb
        ebs:
          volume_size: 20
          delete_on_termination: true
          volume_type: standard
    tag_specifications:
      - resource_type: instance
        tags:
          OsType: Linux
      - resource_type: volume
        tags:
          foo: bar

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

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

Ключ

Описание

default_template

complex

Версия шаблона запуска, которая будет использоваться, если указано только имя шаблона.

Часто она совпадает с последней версией, но не всегда.

Возвращается: когда state=present

create_time

string

Время создания шаблона запуска.

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

created_by

string

Субъект, создавший шаблон запуска.

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

default_version_number

integer

Номер версии по умолчанию шаблона запуска.

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

latest_version_number

integer

Номер последней версии шаблона запуска.

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

launch_template_id

string

Идентификатор шаблона запуска.

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

launch_template_name

string

Имя шаблона запуска.

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

tags

dictionary

Словарь тегов, назначенных образу.

Возвращается: когда AMI создан или уже существует

Пример: {"Env": "devel", "Name": "nat-server"}

default_version

integer

Версия, которая будет использоваться, если указано только имя шаблона. Часто она совпадает с последней версией, но не всегда.

Возвращается: когда default_template имеет номер версии.

deleted_template

complex

Информация об удаленном шаблоне запуска.

Возвращается: когда state=absent

create_time

string

Время создания шаблона запуска.

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

created_by

string

Субъект, создавший шаблон запуска.

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

default_version_number

integer

Номер версии по умолчанию шаблона запуска.

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

latest_version_number

integer

Номер последней версии шаблона запуска.

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

launch_template_id

string

Идентификатор шаблона запуска.

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

launch_template_name

string

Имя шаблона запуска.

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

tags

dictionary

Словарь тегов, назначенных образу.

Возвращается: когда AMI создан или уже существует

Пример: {"Env": "devel", "Name": "nat-server"}

deleted_versions

list / элементы=dictionary

Информация об удаленных версиях шаблона запуска.

Возвращается: когда state=absent

launch_template_id

string

Идентификатор шаблона запуска.

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

launch_template_name

string

Имя шаблона запуска.

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

version_number

integer

Номер версии шаблона запуска.

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

latest_template

complex

Последняя доступная версия шаблона запуска.

Возвращается: когда state=present

create_time

string

Время создания шаблона запуска.

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

created_by

string

Субъект, создавший шаблон запуска.

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

default_version_number

integer

Номер версии по умолчанию шаблона запуска.

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

latest_version_number

integer

Номер последней версии шаблона запуска.

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

launch_template_id

string

Идентификатор шаблона запуска.

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

launch_template_name

string

Имя шаблона запуска.

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

tags

dictionary

Словарь тегов, назначенных образу.

Возвращается: когда AMI создан или уже существует

Пример: {"Env": "devel", "Name": "nat-server"}

latest_version

integer

Номер последней доступной версии шаблона запуска.

Возвращается: когда latest_template имеет номер версии.

template

complex

Последняя доступная версия шаблона запуска.

Возвращается: когда state=present

create_time

string

Время создания шаблона запуска.

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

created_by

string

Субъект, создавший шаблон запуска.

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

default_version_number

integer

Номер версии по умолчанию шаблона запуска.

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

latest_version_number

integer

Номер последней версии шаблона запуска.

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

launch_template_id

string

Идентификатор шаблона запуска.

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

launch_template_name

string

Имя шаблона запуска.

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

tags

dictionary

Словарь тегов, назначенных образу.

Возвращается: когда AMI создан или уже существует

Пример: {"Env": "devel", "Name": "nat-server"}

versions

list / элементы=dictionary

Все доступные версии шаблона запуска.

Возвращается: когда state=present

create_time

string

Время создания версии.

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

created_by

string

Субъект, создавший версию.

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

default_version

boolean

Указывает, является ли версия версией по умолчанию.

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

launch_template_data

dictionary

Информация о шаблоне запуска.

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

Пример: {"block_device_mappings": [{"device_name": "/dev/sdb", "ebs": {"delete_on_termination": true, "encrypted": true, "volumeSize": 5}}], "ebs_optimized": false, "image_id": "ami-0231217be14a6f3ba", "instance_type": "t2.micro", "network_interfaces": [{"associate_public_ip_address": false, "device_index": 0, "ipv6_addresses": [{"ipv6_address": "2001:0:130F:0:0:9C0:876A:130B"}]}]}

block_device_mappings

list / элементы=dictionary

Сопоставления блочных устройств.

Возвращается: если применимо

device_name

string

Имя устройства.

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

ebs

string

Информация о блочном устройстве для тома EBS.

Возвращается: если применимо

delete_on_termination

boolean

Указывает, удаляется ли том EBS при завершении работы экземпляра.

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

encrypted

boolean

Указывает, зашифрован ли том EBS.

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

iops

integer

Количество операций ввода-вывода в секунду (IOPS), поддерживаемое томом.

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

kms_key_id

integer

ARN главного ключа клиента (CMK) службы управления ключами (KMS), используемого для шифрования.

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

snapshot_id

string

Идентификатор снимка.

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

throughput

integer

Пропускная способность тома в МиБ/с.

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

volume_size

integer

Размер тома в ГиБ.

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

volume_type

string

Тип тома.

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

no_device

string

Чтобы исключить устройство из сопоставления блочных устройств, укажите пустую строку.

Возвращается: при успешном выполнении

virtual_name

string

Имя виртуального устройства.

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

cpu_options

dictionary

Параметры ЦП экземпляра.

Возвращается: если применимо

amd_sev_snp

integer

Указывает, включена ли для экземпляра поддержка AMD SEV-SNP.

Возвращается: если применимо

core_count

integer

Количество ядер ЦП экземпляра.

Возвращается: если применимо

threads_per_core

integer

Количество потоков на ядро ЦП.

Возвращается: если применимо

disable_api_termination

boolean

Если задано значение true, это указывает, что экземпляр нельзя завершить с помощью консоли Amazon EC2, инструмента командной строки или API.

Возвращается: если применимо

ebs_optimized

boolean

Указывает, оптимизирован ли экземпляр для операций ввода-вывода Amazon EBS.

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

enclave_options

dictionary

Указывает, включена ли для экземпляра поддержка Amazon Web Services Nitro Enclaves.

Возвращается: если применимо

enabled

boolean

Если для этого параметра задано значение true, для экземпляра включена поддержка Amazon Web Services Nitro Enclaves.

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

iam_instance_profile

dictionary

Профиль экземпляра IAM.

Возвращается: если применимо

arn

string

Имя ресурса Amazon (ARN) профиля экземпляра.

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

name

string

Имя профиля экземпляра.

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

image_id

string

Идентификатор AMI или параметра Systems Manager.

Возвращается: если применимо

instance_initiated_shutdown_behavior

string

Указывает, останавливается или завершается экземпляр при инициировании завершения работы из самого экземпляра.

Возвращается: если применимо

instance_type

string

Тип экземпляра.

Возвращается: если применимо

kernel_id

string

Идентификатор ядра.

Возвращается: если применимо

key_name

string

Имя пары ключей.

Возвращается: если применимо

metadata_options

dictionary

Параметры метаданных экземпляра.

Возвращается: если применимо

http_endpoint

string

Включает или отключает конечную точку HTTP для метаданных экземпляров.

Возвращается: если применимо

http_protocol_ipv6

string

Включает или отключает конечную точку IPv6 для службы метаданных экземпляров.

Возвращается: если применимо

http_put_response_hop_limit

integer

Требуемое ограничение переходов для ответа HTTP PUT на запросы метаданных экземпляра.

Возвращается: если применимо

http_tokens

string

Указывает, требуется ли IMDSv2.

Возвращается: если применимо

instance_metadata_tags

string

Задайте значение enabled, чтобы разрешить доступ к тегам экземпляра через его метаданные.

Возвращается: если применимо

state

string

Состояние изменений параметров метаданных.

Возвращается: если применимо

monitoring

dictionary

Мониторинг экземпляра.

Возвращается: если применимо

enabled

boolean

Указывает, включен ли подробный мониторинг. В противном случае включен базовый мониторинг.

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

network_interfaces

list / elements=dictionary

Сетевые интерфейсы.

Возвращается: если применимо

associate_carrier_ip_address

boolean

Указывает, следует ли назначить Carrier IP-адрес интерфейсу eth0 для нового сетевого интерфейса.

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

associate_public_ip_address

boolean

Указывает, следует ли назначить общедоступный адрес IPv4 интерфейсу eth0 для нового сетевого интерфейса.

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

connection_tracking_specification

dictionary

Спецификация отслеживания подключений группы безопасности, позволяющая задать тайм-аут отслеживания подключений для эластичного сетевого интерфейса.

Возвращается: если применимо

tcp_established_timeout

integer

Тайм-аут (в секундах) для неактивных TCP-подключений в установленном состоянии.

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

udp_stream_timeout

integer

Тайм-аут (в секундах) для неактивных потоков UDP, классифицированных как потоки, в которых произошло более одной транзакции «запрос — ответ».

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

udp_timeout

integer

Тайм-аут (в секундах) для неактивных потоков UDP, в которых трафик передавался только в одном направлении или произошла только одна транзакция «запрос — ответ».

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

delete_on_termination

boolean

Указывает, удаляется ли сетевой интерфейс при завершении экземпляра.

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

description

string

Описание сетевого интерфейса.

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

device_index

integer

Индекс устройства для подключения сетевого интерфейса.

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

ena_srd_specification

dictionary

Содержит настройки ENA Express для экземпляров, запущенных на основе шаблона запуска.

Возвращается: если применимо

ena_srd_enabled

boolean

Указывает, включен ли ENA Express для сетевого интерфейса.

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

ena_srd_udp_specification

dictionary

Настраивает ENA Express для сетевого трафика UDP.

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

ena_srd_udp_enabled

boolean

Указывает, использует ли UDP-трафик к экземпляру и от него ENA Express.

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

groups

list / elements=string

Идентификаторы одной или нескольких групп безопасности.

Возвращается: если применимо

interface_type

string

Тип сетевого интерфейса.

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

ipv4_prefix_count

integer

Количество префиксов IPv4, автоматически назначенных Amazon Web Services сетевому интерфейсу.

Возвращается: если применимо

ipv4_prefixes

list / elements=dictionary

Список префиксов IPv4, назначенных сетевому интерфейсу.

Возвращается: если применимо

ipv4_prefix

string

Делегированные префиксы IPv4, назначенные сетевому интерфейсу.

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

ipv6_address_count

integer

Количество адресов IPv6 для сетевого интерфейса.

Возвращается: если применимо

ipv6_addresses

list / elements=dictionary

Адреса IPv6 сетевого интерфейса.

Возвращается: если применимо

ipv6_address

string

Адрес IPv6.

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

is_primary_ipv6

boolean

Определяет, является ли адрес IPv6, связанный с сетевым интерфейсом, основным адресом IPv6.

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

ipv6_prefix_count

integer

Количество префиксов IPv6, автоматически назначенных Amazon Web Services сетевому интерфейсу.

Возвращается: если применимо

ipv6_prefixes

list / elements=dictionary

Список префиксов IPv6, назначенных сетевому интерфейсу.

Возвращается: если применимо

ipv6_prefix

string

Делегированные префиксы IPv6, назначенные сетевому интерфейсу.

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

network_card_index

integer

Индекс сетевой карты.

Возвращается: если применимо

network_interface_id

string

Идентификатор сетевого интерфейса.

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

primary_ipv6

string

Основной IPv6-адрес сетевого интерфейса.

Возвращается: если применимо

private_ip_address

string

Основной частный IPv4-адрес сетевого интерфейса.

Возвращается: если применимо

private_ip_addresses

list / elements=string

Список частных IPv4-адресов.

Возвращается: если применимо

primary

boolean

Указывает, является ли частный IPv4-адрес основным частным IPv4-адресом.

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

private_ip_address

boolean

Частный IPv4-адрес.

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

secondary_private_ip_address_count

integer

Количество дополнительных частных IPv4-адресов сетевого интерфейса.

Возвращается: если применимо

subnet_id

string

Идентификатор подсети для сетевого интерфейса.

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

placement

dictionary

Размещение экземпляра.

Возвращается: если применимо

affinity

string

Настройка привязки экземпляра к выделенному хосту.

Возвращается: если применимо

availability_zone

string

Зона доступности экземпляра.

Возвращается: если применимо

group_id

string

Идентификатор группы размещения.

Возвращается: если применимо

group_name

string

Имя группы размещения экземпляра.

Возвращается: если применимо

host_id

string

Идентификатор выделенного хоста для экземпляра.

Возвращается: если применимо

host_resource_group_arn

string

ARN группы ресурсов хостов, в которой следует запускать экземпляры.

Возвращается: если применимо

partition_number

integer

Номер раздела, в котором следует запустить экземпляр.

Возвращается: если применимо

tenancy

string

Аренда экземпляра.

Возвращается: если применимо

ram_disk_id

string

Идентификатор RAM-диска, если применимо.

Возвращается: если применимо

security_group_ids

list / elements=string

Идентификаторы групп безопасности.

Возвращается: если применимо

security_groups

list / elements=string

Имена групп безопасности.

Возвращается: если применимо

tag_specifications

list / elements=dictionary

Теги, применяемые к ресурсам, создаваемым при запуске экземпляра.

Возвращается: если применимо

resource_type

string

Тип ресурса, которому нужно назначить тег.

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

tags

list / elements=dictionary

Теги ресурса.

Возвращается: при успешном выполнении

key

string

Ключ тега.

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

value

string

Значение тега.

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

user_data

string

Пользовательские данные экземпляра.

Возвращается: если применимо

launch_template_id

string

Идентификатор шаблона запуска.

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

launch_template_name

string

Имя шаблона запуска.

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

version_description

string

Описание версии.

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

version_number

integer

Номер версии.

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

Авторы

  • Ryan Scott Brown (@ryansb)

Ссылки на коллекцию

  • Отслеживание проблем
  • Репозиторий (исходный код)
  • Общение

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/amazon/aws/ec2_launch_template_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API