Модуль amazon.aws.elb_classic_lb — создание, обновление и удаление Amazon ELB

Примечание

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

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

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

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

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

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Создаёт, обновляет и удаляет Amazon Elastic Load Balancer (ELB).
В версии 2.1.0 коллекции amazon.aws этот модуль был переименован из amazon.aws.ec2_elb_lb в amazon.aws.elb_classic_lb.

Псевдонимы: ec2_elb_lb

Требования

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

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 для соответствия AWS botocore SDK.
access_logs dictionary	Словарь с параметрами настройки журналов доступа (см. примеры).
enabled boolean	Значение `true` включает доставку журналов доступа в корзину S3. Значение `false` отключает доставку журналов доступа. Возможные значения: `false` `true` ← (по умолчанию)
interval integer	Интервал публикации журналов доступа в S3. Возможные значения: `5` `60` ← (по умолчанию)
s3_location string	Корзина S3, в которую следует доставлять журналы доступа. Дополнительные сведения о необходимых политиках корзины S3 см. здесь: https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-access-logs.html. Обязателен, если `access_logs.enabled=true`.
s3_prefix string	Расположение журналов в корзине S3. Если префикс не указан или задано значение `""`, журнал помещается в корень корзины. По умолчанию: `""`
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.
connection_draining_timeout integer	Подождать указанный период времени, чтобы соединения завершились, прежде чем завершать работу экземпляра. Задайте значение `0`, чтобы отключить дренирование соединений.
cross_az_load_balancing boolean	Распределять нагрузку между всеми настроенными зонами доступности. По умолчанию — `false`. Возможные значения: `false` `true`
debug_botocore_endpoint_logs boolean	Использовать регистратор `botocore.endpoint` для анализа уникальных (а не общих) вызовов API `"resource:action"`, выполненных во время задачи, и выводить их набор в ключ resource_actions результатов задачи. Используйте callback `aws_resource_action` для вывода общего списка вызовов, выполненных в ходе плейбука. Также можно использовать переменную среды `ANSIBLE_DEBUG_BOTOCORE_LOGS`. Возможные значения: `false` ← (по умолчанию) `true`
endpoint_url aliases: aws_endpoint_url string	URL для подключения вместо стандартных конечных точек AWS. Это можно использовать для подключения к другим совместимым с AWS службам, однако коллекции amazon.aws и community.aws тестируются только с AWS. Также можно использовать переменную среды `AWS_URL`.
health_check dictionary	Словарь с параметрами проверки работоспособности (см. примеры).
healthy_threshold integer / обязательный	Количество последовательных успешных проверок работоспособности, необходимое для перевода экземпляра в состояние работоспособности.
interval integer / обязательный	Приблизительный интервал в секундах между проверками работоспособности отдельного экземпляра.
ping_path string	Путь URI, к которому ELB обращается при проверке работоспособности. Обязателен, если `health_check.ping_protocol=HTTP` или `health_check.ping_protocol=HTTPS`.
ping_port integer / обязательный	Порт TCP, к которому ELB подключается при проверке работоспособности.
ping_protocol string / обязательный	Протокол, используемый ELB при проверке работоспособности. Допустимые значения: `'HTTP'`, `'HTTPS'`, `'TCP'` и `'SSL'`.
timeout aliases: response_timeout integer / обязательный	Время в секундах, по истечении которого отсутствие ответа означает неудачную проверку работоспособности.
unhealthy_threshold integer / обязательный	Количество последовательных неудачных проверок работоспособности, необходимое для перевода экземпляра в неработоспособное состояние.
idle_timeout integer	Время ожидания соединений ELB с клиентами и серверами до истечения срока действия.
instance_ids list / elements=string	Список идентификаторов экземпляров, подключаемых к этому ELB.
listeners list / elements=dictionary	Список портов и протоколов, которые будет прослушивать этот ELB (см. примеры). Обязателен, если `state=present` и ELB не существует.
instance_port integer / обязательный	Порт, который прослушивает экземпляр.
instance_protocol string	Протокол для маршрутизации трафика к экземплярам. Допустимые значения: `HTTP`, `HTTPS`, `TCP` или `SSL`,
load_balancer_port integer / обязательный	Порт, который будет прослушивать балансировщик нагрузки.
protocol string / обязательный	Транспортный протокол для маршрутизации. Допустимые значения: `HTTP`, `HTTPS`, `TCP` или `SSL`.
proxy_protocol boolean	Включить протокол Proxy для прослушивателя. Обратите внимание: настройки протокола Proxy в ELB применяются на уровне `listeners.instance_port`. Если несколько прослушивателей взаимодействуют с одним и тем же `listeners.instance_port`, это повлияет на них все. Возможные значения: `false` `true`
ssl_certificate_id string	Имя ресурса Amazon (ARN) сертификата SSL.
name string / обязательный	Имя ELB. Имя ELB должно содержать менее 32 символов и быть уникальным в пределах региона и учетной записи.
profile aliases: 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_instance_ids boolean	Удалять существующие идентификаторы экземпляров ELB, отсутствующие в `instance_ids`. Возможные значения: `false` ← (по умолчанию) `true`
purge_listeners boolean	Удалять существующие прослушиватели ELB, отсутствующие в списке listeners. Возможные значения: `false` `true` ← (по умолчанию)
purge_subnets boolean	Удалять существующие подсети ELB, отсутствующие в `subnets`. Поскольку добавлять несколько подсетей из одной зоны доступности запрещено, удаляемые подсети будут удалены до добавления новых. При попытке заменить все подсети сразу это может привести к кратковременному сбою. Возможные значения: `false` ← (по умолчанию) `true`
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` ← (по умолчанию)
purge_zones boolean	Удалять существующие зоны доступности ELB, отсутствующие в `zones`. Возможные значения: `false` ← (по умолчанию) `true`
region aliases: aws_region string	Регион AWS. Для глобальных служб, таких как IAM, Route53 и CloudFront, параметр region игнорируется. Также можно использовать переменную среды `AWS_REGION`. Дополнительные сведения см. в документации Amazon AWS: http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region.
scheme string	Схема, используемая при создании ELB. Для ELB, доступного только в частной VPC, используйте `internal`. При изменении схемы на другое значение текущий ELB будет удален и создан новый. По умолчанию — `scheme=internet-facing`. Возможные значения: `"internal"` `"internet-facing"`
secret_key aliases: 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 botocore SDK.
security_group_ids list / elements=string	Список групп безопасности, применяемых к ELB.
security_group_names list / elements=string	Список имен групп безопасности, применяемых к ELB.
session_token aliases: 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 являются взаимоисключающими.
state string / обязательный	Создать или удалить ELB. Возможные значения: `"absent"` `"present"`
stickiness dictionary	Словарь с параметрами политики привязки сеанса. Политика применяется ко всем прослушивателям (см. примеры).
cookie string	Имя cookie приложения, используемой для привязки сеанса. Обязателен, если `stickiness.enabled=true` и `stickiness.type=application`. Игнорируется, если `stickiness.enabled=false`.
enabled boolean	Если задано `stickiness.enabled=false`, привязка сеанса будет отключена для всех прослушивателей. Возможные значения: `false` `true` ← (по умолчанию)

expiration integer	Период времени в секундах, по истечении которого cookie считается устаревшей. Если этот параметр не указан, сеанс закрепления длится до завершения сеанса браузера. Игнорируется, если `stickiness.enabled=false`.
type string	Тип политики закрепления, которую следует применить. Обязательно, если `stickiness.enabled=true`. Игнорируется, если `stickiness.enabled=false`. Варианты: `"application"` `"loadbalancer"`
subnets list / elements=string	Список подсетей VPC, которые следует использовать при создании ELB. Взаимоисключающий параметр с `zones`.
tags псевдонимы: resource_tags dictionary	Словарь, содержащий теги, которые следует применить к ресурсу. Если параметр `tags` не задан, теги изменены не будут.
validate_certs boolean	Если установлено значение `false`, SSL-сертификаты не будут проверяться при взаимодействии с API AWS. Настоятельно не рекомендуется устанавливать validate_certs=false; вместо этого рассмотрите возможность задать aws_ca_bundle. Варианты: `false` `true` ← (по умолчанию)
wait boolean	При создании, удалении или добавлении экземпляров в ELB, если wait=true, Ansible будет ожидать завершения создания или удаления балансировщика нагрузки и связанных с ним сетевых интерфейсов. Поддержка ожидания при добавлении экземпляров появилась в выпуске 2.1.0. Варианты: `false` ← (по умолчанию) `true`
wait_timeout integer	Используется вместе с wait. Количество секунд ожидания завершения работы ELB. Максимально допустимое значение — 600 секунд (10 минут). По умолчанию: `180`
zones list / elements=string	Список зон доступности, которые следует включить для этого ELB. Взаимоисключающий параметр с `subnets`.

Примечания

Примечание

Факт ec2_elb, ранее устанавливавшийся этим модулем, объявлен устаревшим в выпуске 2.1.0 и больше не устанавливается начиная с выпуска 4.0.0.
Поддержка purge_tags добавлена в выпуске 2.1.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.

Примеры

# Note: None of these examples set aws_access_key, aws_secret_key, or region.
# It is assumed that their matching environment variables are set.

# Basic provisioning example (non-VPC)

- amazon.aws.elb_classic_lb:
    name: "test-please-delete"
    state: present
    zones:
      - us-east-1a
      - us-east-1d
    listeners:
      - protocol: http # options are http, https, ssl, tcp
        load_balancer_port: 80
        instance_port: 80
        proxy_protocol: true
      - protocol: https
        load_balancer_port: 443
        instance_protocol: http # optional, defaults to value of protocol setting
        instance_port: 80
        # ssl certificate required for https or ssl
        ssl_certificate_id: "arn:aws:iam::123456789012:server-certificate/company/servercerts/ProdServerCert"

# Internal ELB example

- amazon.aws.elb_classic_lb:
    name: "test-vpc"
    scheme: internal
    state: present
    instance_ids:
      - i-abcd1234
    purge_instance_ids: true
    subnets:
      - subnet-abcd1234
      - subnet-1a2b3c4d
    listeners:
      - protocol: http # options are http, https, ssl, tcp
        load_balancer_port: 80
        instance_port: 80

# Configure a health check and the access logs
- amazon.aws.elb_classic_lb:
    name: "test-please-delete"
    state: present
    zones:
      - us-east-1d
    listeners:
      - protocol: http
        load_balancer_port: 80
        instance_port: 80
    health_check:
      ping_protocol: http # options are http, https, ssl, tcp
      ping_port: 80
      ping_path: "/index.html" # not required for tcp or ssl
      response_timeout: 5 # seconds
      interval: 30 # seconds
      unhealthy_threshold: 2
      healthy_threshold: 10
    access_logs:
      interval: 5 # minutes (defaults to 60)
      s3_location: "my-bucket" # This value is required if access_logs is set
      s3_prefix: "logs"

# Ensure ELB is gone
- amazon.aws.elb_classic_lb:
    name: "test-please-delete"
    state: absent

# Ensure ELB is gone and wait for check (for default timeout)
- amazon.aws.elb_classic_lb:
    name: "test-please-delete"
    state: absent
    wait: true

# Ensure ELB is gone and wait for check with timeout value
- amazon.aws.elb_classic_lb:
    name: "test-please-delete"
    state: absent
    wait: true
    wait_timeout: 600

# Normally, this module will purge any listeners that exist on the ELB
# but aren't specified in the listeners parameter. If purge_listeners is
# false it leaves them alone
- amazon.aws.elb_classic_lb:
    name: "test-please-delete"
    state: present
    zones:
      - us-east-1a
      - us-east-1d
    listeners:
      - protocol: http
        load_balancer_port: 80
        instance_port: 80
    purge_listeners: false

# Normally, this module will leave availability zones that are enabled
# on the ELB alone. If purge_zones is true, then any extraneous zones
# will be removed
- amazon.aws.elb_classic_lb:
    name: "test-please-delete"
    state: present
    zones:
      - us-east-1a
      - us-east-1d
    listeners:
      - protocol: http
        load_balancer_port: 80
        instance_port: 80
    purge_zones: true

# Creates a ELB and assigns a list of subnets to it.
- amazon.aws.elb_classic_lb:
    state: present
    name: 'New ELB'
    security_group_ids: 'sg-123456, sg-67890'
    subnets: 'subnet-123456,subnet-67890'
    purge_subnets: true
    listeners:
      - protocol: http
        load_balancer_port: 80
        instance_port: 80

# Create an ELB with connection draining, increased idle timeout and cross availability
# zone load balancing
- amazon.aws.elb_classic_lb:
    name: "New ELB"
    state: present
    connection_draining_timeout: 60
    idle_timeout: 300
    cross_az_load_balancing: "yes"
    zones:
      - us-east-1a
      - us-east-1d
    listeners:
      - protocol: http
        load_balancer_port: 80
        instance_port: 80

# Create an ELB with load balancer stickiness enabled
- amazon.aws.elb_classic_lb:
    name: "New ELB"
    state: present
    zones:
      - us-east-1a
      - us-east-1d
    listeners:
      - protocol: http
        load_balancer_port: 80
        instance_port: 80
    stickiness:
      type: loadbalancer
      enabled: true
      expiration: 300

# Create an ELB with application stickiness enabled
- amazon.aws.elb_classic_lb:
    name: "New ELB"
    state: present
    zones:
      - us-east-1a
      - us-east-1d
    listeners:
      - protocol: http
        load_balancer_port: 80
        instance_port: 80
    stickiness:
      type: application
      enabled: true
      cookie: SESSIONID

# Create an ELB and add tags
- amazon.aws.elb_classic_lb:
    name: "New ELB"
    state: present
    zones:
      - us-east-1a
      - us-east-1d
    listeners:
      - protocol: http
        load_balancer_port: 80
        instance_port: 80
    tags:
      Name: "New ELB"
      stack: "production"
      client: "Bob"

# Delete all tags from an ELB
- amazon.aws.elb_classic_lb:
    name: "New ELB"
    state: present
    zones:
      - us-east-1a
      - us-east-1d
    listeners:
      - protocol: http
        load_balancer_port: 80
        instance_port: 80
    tags: {}

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

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

Ключ	Описание
elb dictionary	Атрибуты балансировщика нагрузки в исходном стиле boto. Возвращается: всегда
app_cookie_policy string	Название политики, определяющей, использует ли ELB политику привязки к приложенческой cookie. Возвращается: когда `state=present` Пример: `"ec2-elb-lb-AppCookieStickinessPolicyType"`
backends string	Описание политики серверной части, применённой к ELB (порт экземпляра:название политики). Возвращается: когда `state=present` Пример: `"8181:ProxyProtocol-policy"`
connection_draining_timeout integer	Максимальное время в секундах, в течение которого существующие соединения остаются открытыми перед отменой регистрации экземпляров. Возвращается: когда `state=present` Пример: `25`
cross_az_load_balancing string	`"yes"`, если балансировка нагрузки между зонами доступности включена, или `"no"`, если балансировка нагрузки между зонами доступности отключена. Возвращается: когда `state=present` Пример: `"yes"`
dns_name string	DNS-имя ELB. Возвращается: когда `state=present` Пример: `"internal-ansible-test-935c585850ac-1516306744.us-east-1.elb.amazonaws.com"`
health_check dictionary	Словарь с описанием проверки работоспособности ELB. Возвращается: когда `state=present`
healthy_threshold integer	Количество успешных проверок работоспособности подряд, необходимое для присвоения экземпляру статуса «работоспособен». Возвращается: при успехе Пример: `2`
interval integer	Интервал в секундах между проверками работоспособности. Возвращается: при успехе Пример: `10`
target string	Протокол, порт и, для проверок работоспособности HTTP(S), путь, проверяемый при выполнении проверки. Возвращается: при успехе Пример: `"TCP:22"`
timeout integer	Время в секундах, по истечении которого выполняющаяся проверка работоспособности считается неудачной из-за превышения времени ожидания. Возвращается: при успехе Пример: `5`
unhealthy_threshold integer	Количество неудачных проверок работоспособности подряд, необходимое для присвоения экземпляру статуса «неработоспособен». Возвращается: при успехе Пример: `2`
hosted_zone_id string	Идентификатор размещённой зоны Amazon Route 53 для балансировщика нагрузки. Возвращается: когда `state=present` Пример: `"Z35SXDOTRQ7X7K"`
hosted_zone_name string	DNS-имя балансировщика нагрузки при использовании пользовательского имени хоста. Возвращается: когда `state=present` Пример: `"ansible-module.example"`
idle_timeout integer	Время, по истечении которого ELB разрывает неактивное соединение. Возвращается: когда `state=present` Пример: `50`
in_service_count integer	Количество экземпляров, подключённых к ELB и находящихся в рабочем состоянии. Возвращается: когда `state=present` Пример: `1`
instance_health list / elements=dictionary	Список словарей с описанием состояния каждого экземпляра, подключённого к ELB. Возвращается: когда `state=present`
description string	Понятное человеку описание причины, по которой экземпляр не находится в рабочем состоянии. Возвращается: когда `state=present` Пример: `"N/A"`
instance_id string	Идентификатор экземпляра. Возвращается: когда `state=present` Пример: `"i-03dcc8953a03d6435"`
reason_code string	Код, описывающий причину, по которой экземпляр не находится в рабочем состоянии. Возвращается: когда `state=present` Пример: `"N/A"`
state string	Текущее состояние экземпляра в службе. Возвращается: когда `state=present` Пример: `"InService"`
instances list / elements=string	Список идентификаторов экземпляров, подключённых к ELB. Возвращается: когда `state=present` Пример: `["i-03dcc8953a03d6435"]`
lb_cookie_policy string	Название политики, определяющей, использует ли ELB политику привязки к cookie. Возвращается: когда `state=present` Пример: `"ec2-elb-lb-LBCookieStickinessPolicyType"`
listeners list / elements=list	Список списков с описанием прослушивателей, подключённых к ELB. Вложенный список содержит порт прослушивателя, порт экземпляра, протокол прослушивателя, порт экземпляра и, если применимо, идентификатор SSL-сертификата для порта. Возвращается: когда `state=present` Пример: `[[22, 22, "TCP", "TCP"], [80, 8181, "HTTP", "HTTP"]]`
name string	Название ELB. Это название уникально в пределах региона и учётной записи. Возвращается: когда `state=present` Пример: `"ansible-test-935c585850ac"`
out_of_service_count integer	Количество экземпляров, подключённых к ELB и находящихся вне рабочего состояния. Возвращается: когда `state=present` Пример: `0`
proxy_policy string	Название политики, определяющей, использует ли ELB протокол Proxy. Возвращается: если существует политика протокола Proxy. Пример: `"ProxyProtocol-policy"`
region string	Регион AWS, в котором работает ELB. Возвращается: всегда Пример: `"us-east-1"`
scheme string	Является ли ELB `'internal'` или `'internet-facing'` балансировщиком нагрузки. Возвращается: когда `state=present` Пример: `"internal"`
security_group_ids list / elements=string	Список идентификаторов групп безопасности, подключённых к ELB. Возвращается: когда `state=present` Пример: `["sg-0c12ebd82f2fb97dc", "sg-01ec7378d0c7342e6"]`
status string	Краткое описание текущего состояния ELB. Допустимые значения: `'exists'`, `'gone'`, `'deleted'`, `'created'`. Возвращается: всегда Пример: `"exists"`
subnets list / elements=string	Список идентификаторов подсетей, подключённых к ELB. Возвращается: когда `state=present` Пример: `["subnet-00d9d0f70c7e5f63c", "subnet-03fa5253586b2d2d5"]`
tags dictionary	Словарь с описанием тегов, назначенных ELB. Возвращается: когда `state=present` Пример: `{"ExampleTag": "Example Value", "Name": "ansible-test-935c585850ac"}`
unknown_instance_state_count integer	Количество экземпляров, подключённых к ELB и находящихся в неизвестном состоянии. Возвращается: когда `state=present` Пример: `0`
zones list / elements=string	Список регионов AWS, в которых работает ELB. Возвращается: когда `state=present` Пример: `["us-east-1b", "us-east-1a"]`
load_balancer dictionary	Атрибуты балансировщика нагрузки в стиле Boto3. Возвращается: всегда
availability_zone list / elements=string	Список регионов AWS, в которых работает ELB. Возвращается: когда `state=present` Пример: `["us-east-1b", "us-east-1a"]`
backend_server_descriptions list / elements=dictionary	Сведения о ваших экземплярах EC2. Возвращается: когда `state=present` Пример: `[]`
instance_port integer	Порт, на котором прослушивает соединения экземпляр EC2. Возвращается: когда `state=present`
policy_names list / elements=string	Названия политик, включённых для экземпляра EC2. Возвращается: когда `state=present`
canonical_hosted_zone_id string	Идентификатор размещённой зоны Amazon Route 53 для балансировщика нагрузки. Возвращается: когда `state=present` Пример: `"Z35SXDOTRQ7X7K"`
created_time string	Дата и время создания балансировщика нагрузки. Возвращается: когда `state=present` Пример: `"2024-06-27T10:18:48.390000+00:00"`
dns_name string	DNS-имя ELB. Возвращается: когда `state=present` Пример: `"internal-ansible-test-935c585850ac-1516306744.us-east-1.elb.amazonaws.com"`
health_check dictionary	Сведения о проверках работоспособности, выполняемых балансировщиком нагрузки. Возвращается: когда `state=present`
healthy_threshold integer	Количество успешных проверок работоспособности подряд, необходимое для присвоения экземпляру статуса «работоспособен». Возвращается: при успехе Пример: `2`

interval integer	Время в секундах между проверками работоспособности. Возвращается: success Пример: `10`
target string	Протокол, порт и путь, проверяемый проверкой работоспособности HTTP(S). Возвращается: success Пример: `"TCP:22"`
timeout integer	Время в секундах, по истечении которого выполняющаяся проверка работоспособности считается неудачной из-за тайм-аута. Возвращается: success Пример: `5`
unhealthy_threshold integer	Количество последовательных неудачных проверок работоспособности, после которого экземпляр помечается как неисправный. Возвращается: success Пример: `2`
instances list / elements=dictionary	Идентификаторы экземпляров балансировщика нагрузки. Возвращается: когда `state=present` Пример: `[]`
instance_id string	Идентификатор экземпляра. Возвращается: success
listener_descriptions list / elements=dictionary	Прослушиватели балансировщика нагрузки. Возвращается: когда `state=present` Пример: `[{"listener": {"instance_port": 8080, "instance_protocol": "HTTP", "load_balancer_port": 8080, "protocol": "HTTP"}, "policy_names": []}]`
listener dictionary	Прослушиватель. Возвращается: когда `state=present`
instance_port integer	Порт, на котором прослушивает экземпляр. Возвращается: когда `state=present`
instance_protocol string	Протокол, используемый для маршрутизации трафика к экземплярам. Возвращается: когда `state=present`
load_balancer_port integer	Порт, на котором прослушивает балансировщик нагрузки. Возвращается: когда `state=present`
protocol string	Транспортный протокол балансировщика нагрузки для маршрутизации: HTTP, HTTPS, TCP или SSL. Возвращается: когда `state=present`
policy_names list / elements=string	Политики. Если ни одна политика не включена, список пуст. Возвращается: когда `state=present`
load_balancer_attributes list / elements=dictionary	Прослушиватели балансировщика нагрузки. Возвращается: когда `state=present`
access_log dictionary	Если включено, балансировщик нагрузки собирает подробную информацию обо всех запросах и передает ее в указанную вами корзину Amazon S3. Возвращается: когда `state=present`
emit_interval integer	Интервал публикации журналов доступа. Возвращается: success Пример: `60`
enabled boolean	Указывает, включены ли журналы доступа для балансировщика нагрузки. Возвращается: success Пример: `false`
s3_bucket_name string	Имя корзины Amazon S3, в которой хранятся журналы доступа. Возвращается: success Пример: `""`
s3_bucket_prefix string	Логическая иерархия, созданная для вашей корзины Amazon S3. Возвращается: success Пример: `""`
addtional_attributes list / elements=dictionary	Любые дополнительные атрибуты. Возвращается: когда `state=present` Пример: `[{"key": "elb.http.desyncmitigationmode", "value": "defensive"}]`
connection_draining dictionary	Если функция включена, балансировщик нагрузки позволяет завершить текущие запросы, прежде чем перенаправить трафик с отмененного или неисправного экземпляра. Возвращается: когда `state=present` Пример: `{"enabled": false, "timeout": 300}`
enabled boolean	Указывает, включено ли завершение соединений для балансировщика нагрузки. Возвращается: success
timeout integer	Максимальное время в секундах, в течение которого существующие соединения остаются открытыми перед отменой регистрации экземпляров. Возвращается: success
connection_settings dictionary	Если функция включена, балансировщик нагрузки позволяет соединениям оставаться неактивными (по соединению не передаются данные) в течение указанного времени Возвращается: когда `state=present` Пример: `{"idle_timeout": 60}`
idle_timeout integer	Время в секундах, в течение которого соединение может оставаться неактивным (по нему не передаются данные), прежде чем балансировщик нагрузки закроет его. Возвращается: success
cross_zone_load_balancing dictionary	Если функция включена, балансировщик нагрузки равномерно распределяет запросы между всеми экземплярами независимо от зон доступности. Возвращается: когда `state=present` Пример: `{"enabled": false}`
enabled boolean	Указывает, включена ли балансировка нагрузки между зонами для балансировщика нагрузки. Возвращается: когда `state=present`
load_balancer_name string	Имя ELB. Возвращается: когда `state=present` Пример: `"ansible-test-935c585850ac"`
load_balancer_policies list / elements=dictionary	Сведения о политиках. Возвращается: когда `state=present` Пример: `[]`
policy_attributes_description dictionary	Сведения об атрибуте политики. Возвращается: когда `state=present`
attribute_name string	Имя атрибута. Возвращается: когда `state=present`
attribute_value string	Значение атрибута. Возвращается: когда `state=present`
policy_name string	Имя политики. Возвращается: когда `state=present`
policy_type_name string	Имя типа политики. Возвращается: когда `state=present`
policies dictionary	Политики, определенные для балансировщика нагрузки. Возвращается: когда `state=present`
app_cookie_stickiness_policies list / elements=dictionary	Политики привязки, созданные с помощью CreateAppCookieStickinessPolicy. Возвращается: когда `state=present`
cookie_name string	Имя cookie приложения, используемой для привязки. Возвращается: когда `state=present` Пример: `""`
policy_name string	Мнемоническое имя создаваемой политики. Возвращается: когда `state=present` Пример: `""`
lb_cookie_stickiness_policies list / elements=dictionary	Политики привязки, созданные с помощью CreateLBCookieStickinessPolicy. Возвращается: когда `state=present`
cookie_expiration_period string	Период времени в секундах, по истечении которого cookie считается устаревшей. Возвращается: когда `state=present` Пример: `""`
policy_name string	Мнемоническое имя создаваемой политики. Возвращается: когда `state=present` Пример: `""`
other_policies list / elements=string	Политики, отличные от политик привязки. Возвращается: когда `state=present` Пример: `[]`
scheme string	Тип балансировщика нагрузки. Возвращается: когда `state=present` Пример: `"internal"`
security_groups list / elements=string	Группы безопасности балансировщика нагрузки. Возвращается: когда `state=present` Пример: `["sg-0c12ebd82f2fb97dc", "sg-01ec7378d0c7342e6"]`
source_security_groups dictionary	Группа безопасности балансировщика нагрузки, которую можно использовать в качестве части входящих правил для зарегистрированных экземпляров. Возвращается: когда `state=present` Пример: `{"group_name": "default", "owner_alias": "721066863947"}`
group_name string	Имя группы безопасности.. Возвращается: success
owner_alias string	Владелец группы безопасности. Возвращается: success

subnets list / elements=string	Список идентификаторов подсетей, подключенных к ELB. Возвращается: when `state=present` Пример: `["subnet-00d9d0f70c7e5f63c", "subnet-03fa5253586b2d2d5"]`
tags dictionary	Словарь, описывающий теги, прикрепленные к ELB. Возвращается: when `state=present` Пример: `{"ExampleTag": "Example Value", "Name": "ansible-test-935c585850ac"}`
vpc_id string	Идентификатор VPC для балансировщика нагрузки. Возвращается: when `state=present` Пример: `"vpc-0c112c24b41d89c34"`

Авторы

Jim Dalton (@jsdalton)
Mark Chappell (@tremble)

Ссылки коллекции

© 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/elb_classic_lb_module.html