elb_target_group_facts - Сбор фактов о целевых группах ELB в AWS
Новая версия 2.4.
Описание
- Сбор фактов о целевых группах ELB в AWS
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- boto
- boto3
- python >= 2.6
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aws_access_key | По умолчанию: None | Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. Псевдонимы: ec2_access_key, access_key |
| aws_secret_key | По умолчанию: None | Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. Псевдонимы: ec2_secret_key, secret_key |
| ec2_url | По умолчанию: None | URL для подключения к EC2 или облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если оно есть. |
| load_balancer_arn | Amazon Resource Name (ARN) балансировщика нагрузки. | |
| names | Имена целевых групп. | |
| profile (добавлено в 1.6) | По умолчанию: None | Использует профиль 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) | По умолчанию: None | Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. Псевдонимы: access_token |
| target_group_arns | Amazon Resource Names (ARN) целевых групп. | |
| validate_certs (добавлено в 1.5) |
| Если установлено "no", сертификаты 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), если учетные данные не предоставлены. См. http://boto.readthedocs.org/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 complex | всегда | список целевых групп | |
| protocol строка | всегда | Протокол для маршрутизации трафика к целевым серверам. Пример: HTTP | |
| tags словарь | всегда | Теги, прикрепленные к целевой группе. Пример: { 'Тег': 'Пример' } | |
| matcher словарь | всегда | HTTP-коды для проверки успешного ответа от целевого сервера. Пример: {'http_code': '200'} | |
| health_check_port строка | всегда | Порт для подключения к целевому серверу. Пример: traffic-port | |
| target_group_name строка | всегда | Имя целевой группы. Пример: mytargetgroup | |
| target_group_arn строка | всегда | Amazon Resource Name (ARN) целевой группы. Пример: arn:aws:elasticloadbalancing:ap-southeast-2:01234567890:targetgroup/mytargetgroup/aabbccddee0044332211 | |
| deregistration_delay_timeout_seconds целое число | всегда | Время ожидания Elastic Load Balancing перед изменением состояния дерегистрируемого целевого сервера с «в режиме ожидания» на «неиспользуемый». Пример: 300 | |
| healthy_threshold_count целое число | всегда | Число последовательных успешных проверок состояния, необходимых для перевода нездорового целевого сервера в здоровое состояние. Пример: 5 | |
| port целое число | всегда | Порт, на котором слушают целевые серверы. Пример: 80 | |
| load_balancer_arns список | всегда | Amazon Resource Names (ARN) балансировщиков нагрузки, которые направляют трафик в эту целевую группу. | |
| health_check_protocol строка | всегда | Протокол для подключения к целевому серверу. Пример: HTTP | |
| unhealthy_threshold_count целое число | всегда | Количество последовательных сбоев проверки состояния, необходимых для признания целевого сервера нездоровым. Пример: 2 | |
| stickiness_type строка | всегда | Тип сессий с привязкой. Пример: lb_cookie | |
| health_check_timeout_seconds целое число | всегда | Время в секундах, в течение которого отсутствие ответа означает сбой проверки состояния. Пример: 5 | |
| stickiness_lb_cookie_duration_seconds целое число | всегда | Указывает, включены ли сессии с привязкой. Пример: 86400 | |
| stickiness_enabled логический | всегда | Указывает, включены ли сессии с привязкой. Пример: True | |
| health_check_path строка | всегда | Цель для запроса проверки состояния. Пример: /index.html | |
| vpc_id строка | всегда | Идентификатор VPC для целевых серверов. Пример: vpc-0123456 | |
| health_check_interval_seconds целое число | всегда | Приблизительное время в секундах между проверками состояния отдельных целевых серверов. Пример: 30 | |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантирует обратную совместимость.
Автор
- 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.5/modules/elb_target_group_facts_module.html