ec2_lc_facts – Сбор фактов о конфигурациях запуска AWS Autoscaling
Новая в версии 2.3.
Описание
- Сбор фактов о конфигурациях запуска AWS Autoscaling
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- 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 |
| Использовать logger botocore.endpoint для анализа уникальных (а не общих) API-вызовов «ресурс:действие», совершаемых во время задачи, выводя набор в ключ resource_actions результатов задачи. Используйте обратный вызов aws_resource_action для вывода общего списка, созданного во время выполнения playbook. Также может быть использована переменная среды ANSIBLE_DEBUG_BOTOCORE_LOGS. |
| ec2_url строка | URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль будет использовать конечные точки EC2). Игнорируется в модулях, где требуется регион. Должен быть указан во всех остальных модулях, если регион не используется. Если не задан, используется значение переменной среды EC2_URL, если таковая есть. | |
| name - | По умолчанию: [] | Имя или список имен для сопоставления. |
| 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. Если не задан, используется значение переменной среды AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token | |
| sort - |
| Необязательный атрибут для сортировки результатов. |
| sort_end - | Результат с которым заканчивается сортировка (при сортировке). Соответствует синтаксису срезов в Python. | |
| sort_order - |
| Порядок сортировки результатов. Используется только при указании параметра 'sort'. |
| sort_start - | Результат с которого начинается сортировка (при сортировке). Соответствует синтаксису срезов в Python. | |
| 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 launch configurations
- ec2_lc_facts:
# Gather facts about launch configuration with name "example"
- ec2_lc_facts:
name: example
# Gather facts sorted by created_time from most recent to least recent
- ec2_lc_facts:
sort: created_time
sort_order: descending
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| block_device_mapping список | всегда | Карта блочных устройств для экземпляров конфигурации запуска Пример: [{ 'device_name': '/dev/xvda':, 'ebs': { 'delete_on_termination': true, 'volume_size': 8, 'volume_type': 'gp2' }] |
| classic_link_vpc_security_groups строка | всегда | ID одного или нескольких групп безопасности для VPC, указанного в classic_link_vpc_id |
| created_time строка | всегда | Дата и время создания конфигурации запуска Пример: 2016-05-27T13:47:44.216000+00:00 |
| ebs_optimized булево значение | всегда | Оптимизирован под EBS ввода/вывода (true) или нет (false) Пример: true, |
| image_id строка | всегда | ID Amazon Machine Image (AMI) Пример: ami-12345678 |
| instance_monitoring словарь | всегда | Запущен с подробным мониторингом или нет Пример: { 'enabled': true } |
| instance_type строка | всегда | Тип экземпляра Пример: t2.micro |
| kernel_id строка | всегда | ID ядра, связанного с AMI |
| key_name строка | всегда | Имя пары ключей Пример: user_app |
| launch_configuration_arn строка | всегда | Amazon Resource Name (ARN) конфигурации запуска Пример: arn:aws:autoscaling:us-east-1:666612345678:launchConfiguration:ba785e3a-dd42-6f02-4585-ea1a2b458b3d:launchConfigurationName/lc-app |
| launch_configuration_name строка | всегда | Имя конфигурации запуска Пример: lc-app |
| ramdisk_id строка | всегда | ID RAM-диска, связанного с AMI |
| security_groups список | всегда | Группы безопасности для привязки Пример: [ 'web' ] |
| user_data строка | всегда | Доступные пользовательские данные |
Статус
- Данный модуль не гарантирует обратную совместимость. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Loïc Latreille (@psykotox)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/ec2_lc_facts_module.html