elb_target_group_facts – Сбор фактов о целевых группах ELB в AWS
Новая версия 2.4.
Краткое описание
- Сбор фактов о целевых группах ELB в AWS
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- boto
- boto3
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aws_access_key - | Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Псевдонимы: ec2_access_key, access_key | |
| aws_secret_key - | Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Псевдонимы: ec2_secret_key, secret_key | |
| ec2_url - | URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех других модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если она есть. | |
| load_balancer_arn - | Amazon Resource Name (ARN) балансировщика нагрузки. | |
| names - | Имена целевых групп. | |
| profile - добавлено в 1.6 | Использует профиль boto. Работает только с boto >= 2.24.0. | |
| region - | Регион AWS. Если не указан, используется значение переменной окружения AWS_REGION или EC2_REGION, если она есть. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
Псевдонимы: aws_region, ec2_region | |
| security_token - добавлено в 1.6 | Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token | |
| target_group_arns - | Amazon Resource Names (ARN) целевых групп. | |
| validate_certs boolean добавлено в 1.5 |
| При значении "нет" сертификаты SSL для boto версий >= 2.6.0 не будут проверяться. |
Примечания
Примечание
- Если параметры не заданы в модуле, можно использовать следующие переменные окружения в порядке убывания приоритета
AWS_URLилиEC2_URL,AWS_ACCESS_KEY_IDилиAWS_ACCESS_KEYилиEC2_ACCESS_KEY,AWS_SECRET_ACCESS_KEYилиAWS_SECRET_KEYилиEC2_SECRET_KEY,AWS_SECURITY_TOKENилиEC2_SECURITY_TOKEN,AWS_REGIONилиEC2_REGION - Ansible использует файл конфигурации boto (обычно ~/.boto), если данные учетных данных не предоставлены. См. https://boto.readthedocs.io/en/latest/boto_config_tut.html
-
AWS_REGIONилиEC2_REGIONможно использовать для указания региона AWS при необходимости, но его также можно настроить в файле конфигурации boto
Примеры
# Note: These examples do not set authentication details, see the AWS Guide for details.
# Gather facts about all target groups
- elb_target_group_facts:
# Gather facts about the target group attached to a particular ELB
- elb_target_group_facts:
load_balancer_arn: "arn:aws:elasticloadbalancing:ap-southeast-2:001122334455:loadbalancer/app/my-elb/aabbccddeeff"
# Gather facts about a target groups named 'tg1' and 'tg2'
- elb_target_group_facts:
names:
- tg1
- tg2
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| target_groups сложный | всегда | список целевых групп | |
| deregistration_delay_timeout_seconds целое число | всегда | Время, в секундах, которое Elastic Load Balancing ждет, прежде чем изменить состояние дерегистрируемой цели с состояния «ожидания» на «неиспользуемая». Пример: 300 | |
| health_check_interval_seconds целое число | всегда | Приблизительное время, в секундах, между проверками состояния отдельной цели. Пример: 30 | |
| health_check_path строка | всегда | Адрес для запроса проверки состояния. Пример: /index.html | |
| health_check_port строка | всегда | Порт для подключения к цели. Пример: traffic-port | |
| health_check_protocol строка | всегда | Протокол для подключения к цели. Пример: HTTP | |
| health_check_timeout_seconds целое число | всегда | Время, в секундах, в течение которого отсутствие ответа означает не пройденную проверку состояния. Пример: 5 | |
| healthy_threshold_count целое число | всегда | Количество последовательных успешных проверок состояния, необходимых для признания нездоровой цели здоровой. Пример: 5 | |
| load_balancer_arns список | всегда | Имена Amazon Resource Names (ARN) балансировщиков нагрузки, которые направляют трафик в эту целевую группу. | |
| matcher словарь | всегда | HTTP-коды, используемые при проверке успешного ответа от цели. Пример: {'http_code': '200'} | |
| port целое число | всегда | Порт, на котором слушают цели. Пример: 80 | |
| protocol строка | всегда | Протокол для маршрутизации трафика к целям. Пример: HTTP | |
| stickiness_enabled булево | всегда | Указывает, включены ли сеансы с "липким" трафиком. Пример: True | |
| stickiness_lb_cookie_duration_seconds целое число | всегда | Указывает, включены ли сеансы с "липким" трафиком. Пример: 86400 | |
| stickiness_type строка | всегда | Тип сеансов с "липким" трафиком. Пример: lb_cookie | |
| tags словарь | всегда | Теги, прикреплённые к целевой группе. Пример: { 'Тег': 'Пример' } | |
| target_group_arn строка | всегда | Идентификатор Amazon Resource Name (ARN) целевой группы. Пример: arn:aws:elasticloadbalancing:ap-southeast-2:01234567890:targetgroup/mytargetgroup/aabbccddee0044332211 | |
| target_group_name строка | всегда | Имя целевой группы. Пример: mytargetgroup | |
| unhealthy_threshold_count целое число | всегда | Количество последовательных сбоев проверки состояния, необходимых для того, чтобы считать цель нездоровой. Пример: 2 | |
| vpc_id строка | всегда | Идентификатор VPC для целей. Пример: vpc-0123456 | |
Состояние
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- Rob White (@wimnat)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/elb_target_group_facts_module.html