elb_application_lb_facts – Сбор фактов об Application Load Balancers в AWS
Новое в версии 2.4.
Описание
- Сбор фактов об Application Load Balancers в 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 | |
| debug_botocore_endpoint_logs логический тип добавлен в 2.8 |
| Использовать логгер botocore.endpoint для анализа уникальных (а не общих) API-вызовов "resource:action" во время задачи, выводив список в ключ resource_actions результатов задачи. Используйте обратный вызов aws_resource_action, чтобы вывести полный список, созданный во время выполнения playbook. |
| ec2_url строка | URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию используется конечная точка EC2). Игнорируется для модулей, где регион обязателен. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если она есть. | |
| load_balancer_arns - | Имена Amazon Resource Names (ARN) балансировщиков нагрузки. Вы можете указать до 20 балансировщиков в одном вызове. | |
| names - | Имена балансировщиков нагрузки. | |
| profile строка | Использует профиль 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 строка | AWS STS security token. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token | |
| validate_certs логический тип |
| Если установлено значение "нет", сертификаты 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_application_lb_facts:
# Gather facts about the target group attached to a particular ELB
- elb_application_lb_facts:
load_balancer_arns:
- "arn:aws:elasticloadbalancing:ap-southeast-2:001122334455:loadbalancer/app/my-elb/aabbccddeeff"
# Gather facts about a target groups named 'tg1' and 'tg2'
- elb_application_lb_facts:
names:
- elb1
- elb2
# Gather facts about specific ALB
- elb_application_lb_facts:
names: "alb-name"
region: "aws-region"
register: alb_facts
- debug: var=alb_facts
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| load_balancers сложный | всегда | список балансировщиков нагрузки | |
| access_logs_s3_bucket строка | при наличии статуса | Имя ведра Amazon S3 для журналов доступа. Пример: mys3bucket | |
| access_logs_s3_enabled строка | при наличии статуса | Указывает, включены ли журналы доступа, хранящиеся в Amazon S3. Пример: True | |
| access_logs_s3_prefix строка | при наличии статуса | Префикс для расположения в ведре S3. Пример: /my/logs | |
| availability_zones список | при наличии статуса | Зоны доступности для балансировщика нагрузки. Пример: [{'subnet_id': 'subnet-aabbccddff', 'zone_name': 'ap-southeast-2a'}] | |
| canonical_hosted_zone_id строка | при наличии статуса | Идентификатор зоны Amazon Route 53, связанной с балансировщиком нагрузки. Пример: ABCDEF12345678 | |
| created_time строка | при наличии статуса | Дата и время создания балансировщика нагрузки. Пример: 2015-02-12T02:14:02+00:00 | |
| deletion_protection_enabled строка | при наличии статуса | Указывает, включена ли защита от удаления. Пример: True | |
| dns_name строка | при наличии статуса | Общедоступное имя DNS балансировщика нагрузки. Пример: internal-my-elb-123456789.ap-southeast-2.elb.amazonaws.com | |
| idle_timeout_timeout_seconds строка | при наличии статуса | Значение таймаута бездействия в секундах. Пример: 60 | |
| ip_address_type строка | при наличии статуса | Тип IP-адресов, используемых подсетями для балансировщика нагрузки. Пример: ipv4 | |
| load_balancer_arn строка | при наличии статуса | Amazon Resource Name (ARN) балансировщика нагрузки. Пример: arn:aws:elasticloadbalancing:ap-southeast-2:0123456789:loadbalancer/app/my-elb/001122334455 | |
| load_balancer_name строка | при наличии статуса | Имя балансировщика нагрузки. Пример: my-elb | |
| scheme строка | при наличии статуса | Балансировщик нагрузки с внешним или внутренним доступом. Пример: internal | |
| security_groups список | при наличии статуса | Идентификаторы групп безопасности для балансировщика нагрузки. Пример: ['sg-0011223344'] | |
| state словарь | при наличии статуса | Состояние балансировщика нагрузки. Пример: {'code': 'active'} | |
| tags словарь | при наличии статуса | Теги, прикрепленные к балансировщику нагрузки. Пример: { 'Tag': 'Пример' } | |
| type строка | при наличии статуса | Тип балансировщика нагрузки. Пример: application | |
| vpc_id строка | при наличии статуса | Идентификатор VPC для балансировщика нагрузки. Пример: vpc-0011223344 | |
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- 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.8/modules/elb_application_lb_facts_module.html