Spec-Zone.ru › Ansible

Модуль amazon.aws.elb_classic_lb – Создаёт, обновляет или удаляет Amazon ELB

Примечание

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

У вас возможно уже установлена эта коллекция, если вы используете пакет 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).
  • Этот модуль был переименован из amazon.aws.ec2_elb_lb в amazon.aws.elb_classic_lb в версии 2.1.0 коллекции amazon.aws.

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

Требования

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

  • python >= 3.6
  • boto3 >= 1.26.0
  • botocore >= 1.29.0
END_OF_DOCUMENT_MARKER

Параметры

Параметр

Комментарии

access_key

псевдонимы: aws_access_key_id, aws_access_key, ec2_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 или EC2_ACCESS_KEY в порядке убывания приоритета.

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

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

Псевдоним ec2_access_key устарел и будет удален в релизе после 2024-12-01.

Поддержка переменной среды EC2_ACCESS_KEY устарела и будет удалена в релизе после 2024-12-01.

access_logs

словарь

Словарь настроек параметров журналов доступа (см. примеры).

enabled

булево

При установке в значение true будут настраиваться доставка журналов доступа в ведро S3.

При установке в значение false доставка журналов доступа будет отключена.

Выбор:

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

interval

целое число

Интервал публикации журналов доступа в S3.

Выбор:

  • 5
  • 60 ← (по умолчанию)

s3_location

строка

Ведро S3 для доставки журналов доступа.

См. https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/enable-access-logs.html для получения дополнительной информации о необходимых политиках ведра S3.

Обязательно при access_logs.enabled=true.

s3_prefix

строка

Место в ведре S3 для доставки журналов.

Если префикс не указан или установлен в значение "", журнал размещается на корневом уровне ведра.

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

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.

connection_draining_timeout

целое число

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

Установлено в значение 0 для отключения закрытия соединений.

cross_az_load_balancing

булево

Распределение нагрузки по всем настроенным зонам доступности.

По умолчанию false.

Выбор:

  • false
  • true

debug_botocore_endpoint_logs

булево

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

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

Выбор:

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

endpoint_url

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

строка

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

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

Псевдонимы ec2_url и s3_url устарели и будут удалены в релизе после 2024-12-01.

Поддержка переменной среды EC2_URL устарела и будет удалена в релизе после 2024-12-01.

health_check

словарь

Словарь настроек проверки состояния (см. примеры).

healthy_threshold

целое число / обязательно

Количество последовательных успешных проверок состояния, необходимых для перевода экземпляра в состояние «Здоровый».

interval

целое число / обязательно

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

ping_path

строка

Путь URI, который проверка состояния ELB будет запрашивать при выполнении проверки состояния.

Требуется при health_check.ping_protocol=HTTP или health_check.ping_protocol=HTTPS.

ping_port

целое число / обязательное

Порт TCP, к которому ELB будет подключаться при выполнении проверки работоспособности.

ping_protocol

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

Протокол, который ELB будет использовать при проверке работоспособности.

Допустимые значения 'HTTP', 'HTTPS', 'TCP' и 'SSL'.

timeout

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

целое число / обязательное

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

unhealthy_threshold

целое число / обязательное

Количество последовательных сбоев проверки работоспособности, необходимое для перевода экземпляра в состояние "Неисправен".

idle_timeout

целое число

Подключения ELB от клиентов и к серверам отключаются по истечении этого времени.

instance_ids

список / элементы=строка

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

listeners

список / элементы=словарь

Список портов/протоколов, на которых должен прослушивать этот ELB (см. примеры).

Требуется при state=present и если ELB не существует.

instance_port

целое число / обязательное

Порт, на котором прослушивает экземпляр.

instance_protocol

строка

Протокол, используемый для маршрутизации трафика к экземплярам.

Допустимые значения HTTP, HTTPS, TCP, или SSL,

load_balancer_port

целое число / обязательное

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

protocol

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

Транспортный протокол для маршрутизации.

Допустимые значения HTTP, HTTPS, TCP, или SSL.

proxy_protocol

логическое

Включить протокол прокси для прослушивателя.

Обратите внимание, что ELB контролирует протокол прокси на основе listeners.instance_port. Если у вас несколько слушателей, которые взаимодействуют с тем же listeners.instance_port, это повлияет на все из них.

Варианты:

  • false
  • true

ssl_certificate_id

строка

Amazon Resource Name (ARN) сертификата SSL.

name

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

Имя ELB.

Имя ELB должно быть менее 32 символов и уникальным в регионе и аккаунте.

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 и security_token.

purge_instance_ids

логическое

Очистить существующие идентификаторы экземпляров на ELB, которые не найдены в instance_ids.

Варианты:

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

purge_listeners

логическое

Очистить существующие прослушиватели на ELB, которые не найдены в listeners.

Варианты:

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

purge_subnets

логическое

Очистить существующие подсети на ELB, которые не найдены в subnets.

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

Варианты:

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

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

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

строка

AWS регион для использования.

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

Также могут быть использованы переменные окружения AWS_REGION или EC2_REGION.

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

Псевдоним ec2_region устарел и будет удален в выпуске после 2024-12-01

Поддержка переменной среды EC2_REGION устарела и будет удалена в выпуске после 2024-12-01.

scheme

строка

Схема для использования при создании ELB.

Для ELB, видимой в частной VPC, используйте internal.

Если вы выберете обновление схемы с другим значением, ELB будет удалена, и будет создана новая ELB.

По умолчанию scheme=internet-facing.

Варианты:

  • "internal"
  • "internet-facing"

secret_key

псевдонимы: aws_secret_access_key, aws_secret_key, ec2_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, или EC2_SECRET_KEY также могут быть использованы в порядке убывания приоритета.

Параметры secret_key и profile взаимоисключают друг друга.

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

Псевдоним ec2_secret_key устарел и будет удален в выпуске после 2024-12-01.

Поддержка переменной окружения EC2_SECRET_KEY устарела и будет удалена в выпуске после 2024-12-01.

security_group_ids

список / элементы=строка

Список групп безопасности, применяемых к ELB.

security_group_names

список / элементы=строка

Список имён групп безопасности, применяемых к ELB.

session_token

псевдонимы: aws_session_token, security_token, aws_security_token, access_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, AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN также могут быть использованы в порядке убывания приоритета.

Параметры security_token и profile взаимоисключают друг друга.

Псевдонимы aws_session_token и session_token были добавлены в релизе 3.2.0, а параметр был переименован из security_token в session_token в релизе 6.0.0.

Псевдонимы security_token, aws_security_token и access_token устарели и будут удалены в выпуске после 2024-12-01.

Поддержка переменных среды EC2_SECRET_KEY и AWS_SECURITY_TOKEN устарела и будет удалена в выпуске после 2024-12-01.

state

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

Создать или удалить ELB.

Варианты:

  • "absent"
  • "present"

stickiness

словарь

Словарь настроек политики привязки.

Политика будет применена ко всем слушателям (см. примеры).

cookie

строка

Имя прикладного cookie, используемого для привязки.

Требуется, если stickiness.enabled=true и stickiness.type=application.

Игнорируется, если stickiness.enabled=false.

enabled

булево

При stickiness.enabled=false политика сеансовой привязки будет отключена для всех слушателей.

Варианты:

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

expiration

целое число

Период времени в секундах, после которого cookie следует считать просроченным.

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

Игнорируется, если stickiness.enabled=false.

type

string

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

Требуется, если stickiness.enabled=true.

Игнорируется, если stickiness.enabled=false.

Варианты:

  • "application"
  • "loadbalancer"

subnets

list / elements=string

Список VPC-подсетей, которые нужно использовать при создании ELB.

Взаимоисключающее с zones.

tags

aliases: resource_tags

dictionary

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

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

validate_certs

boolean

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

Установка 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 «хоста», а не «контроллера». Поэтому файлы может потребоваться скопировать на «хост». Для плагинов lookup и connection переменные среды и конфигурационные файлы считываются из контекста Ansible «контроллера», а не «хоста».
  • AWS SDK (boto3), используемый Ansible, также может читать значения по умолчанию для учетных данных и других настроек, таких как регион, из своих конфигурационных файлов в контексте Ansible «хоста» (обычно ~/.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 (instance-port:policy-name).

Возвращается: когда 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.

Возвращается: когда существует политика протокола прокси.

Пример: "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"]

метки

словарь

Словарь, описывающий метки, прикреплённые к ELB.

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

Пример: {"ExampleTag": "Example Value", "Name": "ansible-test-935c585850ac"}

количество_инстансов_в_неопределённом_состоянии

целое_число

Количество экземпляров, присоединённых к ELB, находящихся в неопределённом состоянии.

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

Пример: 0

зоны

список / элементы=строка

Список AWS регионов, в которых работает ELB.

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

Пример: ["us-east-1b", "us-east-1a"]

балансировщик_нагрузки

словарь

Атрибуты балансировщика нагрузки в стиле Boto3.

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

зона_доступности

список / элементы=строка

Список AWS регионов, в которых работает ELB.

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

Пример: ["us-east-1b", "us-east-1a"]

описания_серверов_обработки

список / элементы=словарь

Информация о ваших экземплярах EC2.

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

Пример: []

порт_экземпляра

целое_число

Порт на экземпляре EC2, на котором он прослушивает подключения.

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

имена_политик

список / элементы=строка

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

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

уникальный_идентификатор_зоны_размещения

строка

Идентификатор зоны размещения Amazon Route 53 для балансировщика нагрузки.

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

Пример: "Z35SXDOTRQ7X7K"

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

строка

Дата и время создания балансировщика нагрузки.

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

Пример: "2024-06-27T10:18:48.390000+00:00"

имя_dns

строка

Имя DNS балансировщика нагрузки.

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

Пример: "internal-ansible-test-935c585850ac-1516306744.us-east-1.elb.amazonaws.com"

проверка_состояния

словарь

Информация о проверках состояния балансировщика нагрузки.

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

пороговое_значение_здоровых_проверок

целое_число

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

Возвращается: успех

Пример: 2

интервал

целое_число

Время в секундах между каждой проверкой состояния.

Возвращается: успех

Пример: 10

цель

строка

Протокол, порт и, для проверок состояния HTTP(S), путь, проверяемый при проверке состояния.

Возвращается: успех

Пример: "TCP:22"

таймаут

целое_число

Время в секундах, после которого незавершенная проверка состояния считается проваленной из-за таймаута.

Возвращается: успех

Пример: 5

пороговое_значение_неисправных_проверок

целое_число

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

Возвращается: успех

Пример: 2

instances

list / elements=dictionary

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

Возвращается: when state=present

Пример: []

instance_id

string

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

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

listener_descriptions

list / elements=dictionary

Слушатели для балансировщика нагрузки.

Возвращается: when state=present

Пример: [{"listener": {"instance_port": 8080, "instance_protocol": "HTTP", "load_balancer_port": 8080, "protocol": "HTTP"}, "policy_names": []}]

listener

dictionary

Слушатель.

Возвращается: when state=present

instance_port

integer

Порт, на котором прослушивает экземпляр.

Возвращается: when state=present

instance_protocol

string

Протокол, используемый для маршрутизации трафика к экземплярам.

Возвращается: when state=present

load_balancer_port

integer

Порт, на котором прослушивает балансировщик нагрузки.

Возвращается: when state=present

protocol

string

Транспортный протокол балансировщика нагрузки, используемый для маршрутизации: HTTP, HTTPS, TCP или SSL.

Возвращается: when state=present

policy_names

list / elements=string

Политики. Если политики не включены, список пуст.

Возвращается: when state=present

load_balancer_attributes

list / elements=dictionary

Слушатели для балансировщика нагрузки.

Возвращается: when state=present

access_log

dictionary

Если включено, балансировщик нагрузки захватывает подробную информацию обо всех запросах и доставляет информацию в указанное вами хранилище Amazon S3.

Возвращается: when 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

Любые дополнительные атрибуты.

Возвращается: when state=present

Пример: [{"key": "elb.http.desyncmitigationmode", "value": "defensive"}]

connection_draining

dictionary

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

Возвращается: when state=present

Пример: {"enabled": false, "timeout": 300}

enabled

boolean

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

Returned: success

timeout

integer

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

Returned: success

connection_settings

dictionary

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

Returned: when state=present

Sample: {"idle_timeout": 60}

idle_timeout

integer

Время, в секундах, в течение которого соединение может быть бездействующим (данные не были отправлены по соединению), прежде чем оно будет закрыто балансировщиком нагрузки.

Returned: success

cross_zone_load_balancing

dictionary

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

Returned: when state=present

Sample: {"enabled": false}

enabled

boolean

Указывает, включена ли межзонная балансировка нагрузки для балансировщика нагрузки.

Returned: when state=present

load_balancer_name

string

Имя ELB.

Returned: when state=present

Sample: "ansible-test-935c585850ac"

load_balancer_policies

list / elements=dictionary

Информация о политиках.

Returned: when state=present

Sample: []

policy_attributes_description

dictionary

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

Returned: when state=present

attribute_name

string

Имя атрибута.

Returned: when state=present

attribute_value

string

Значение атрибута.

Returned: when state=present

policy_name

string

Имя политики.

Returned: when state=present

policy_type_name

string

Имя типа политики.

Returned: when state=present

policies

dictionary

Политики, определенные для балансировщика нагрузки.

Returned: when state=present

app_cookie_stickiness_policies

list / elements=dictionary

Политики постоянства, созданные с помощью CreateAppCookieStickinessPolicy.

Returned: when state=present

cookie_name

string

Имя файла cookie приложения, используемого для постоянства.

Returned: when state=present

Sample: ""

policy_name

string

Мнемоническое имя для создаваемой политики.

Returned: when state=present

Sample: ""

lb_cookie_stickiness_policies

список / элементы=словарь

Политики склеивания, созданные с помощью CreateLBCookieStickinessPolicy.

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

cookie_expiration_period

строка

Период времени в секундах, после которого cookie считается устаревшим.

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

Пример: ""

policy_name

строка

Мнемоническое имя создаваемой политики.

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

Пример: ""

other_policies

список / элементы=строка

Политики, кроме политик склеивания.

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

Пример: []

scheme

строка

Тип балансировщика нагрузки.

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

Пример: "internal"

security_groups

список / элементы=строка

Безопасные группы балансировщика нагрузки.

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

Пример: ["sg-0c12ebd82f2fb97dc", "sg-01ec7378d0c7342e6"]

source_security_groups

словарь

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

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

Пример: {"group_name": "default", "owner_alias": "721066863947"}

group_name

строка

Имя безопасной группы.

Возвращается: успех

owner_alias

строка

Владелец безопасной группы.

Возвращается: успех

subnets

список / элементы=строка

Список идентификаторов подсетей, подключенных к балансировщику ELB.

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

Пример: ["subnet-00d9d0f70c7e5f63c", "subnet-03fa5253586b2d2d5"]

tags

словарь

Словарь, описывающий метки, прикрепленные к балансировщику ELB.

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

Пример: {"ExampleTag": "Example Value", "Name": "ansible-test-935c585850ac"}

vpc_id

строка

Идентификатор VPC для балансировщика нагрузки.

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

Пример: "vpc-0c112c24b41d89c34"

Авторы

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

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

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

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

Spec-Zone.ru

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