route53_facts - Получение данных route53 с использованием методов AWS
Новая версия 2.0.
Описание
- Получает различные данные, связанные с зоной Route53, набором записей или данными проверки работоспособности.
Требования (к хосту, на котором выполняется модуль)
- python >= 2.6
- boto
Параметры
| параметр | обязательно | по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| 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 | ||
| change_id | нет | Идентификатор запроса изменения. Указанное здесь значение — это значение, которое ChangeResourceRecordSets вернул в элементе Id при отправке запроса. | ||
| delegation_set_id | нет | Идентификатор набора делегирования DNS-зоны | ||
| dns_name | нет | Первое имя в лексикографическом порядке доменных имен, с которого команда list_command должна начать перечисление | ||
| ec2_url | нет | URL, используемый для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если таковая имеется. | ||
| health_check_id | нет | Идентификатор проверки работоспособности | ||
| health_check_method | нет | list |
| Используется совместно с запросом: health_check. Позволяет перечислять детали, количество или теги различных данных проверки работоспособности. |
| hosted_zone_id | нет | Идентификатор размещенной зоны DNS-зоны | ||
| hosted_zone_method | нет | list |
| Используется совместно с запросом: hosted_zone. Позволяет перечислять детали, количество или теги различных данных размещенных зон. |
| max_items | нет | Максимальное количество элементов, возвращаемых для различных запросов get/list | ||
| next_marker | нет | Некоторые запросы, такие как list_command: hosted_zones, вернут максимальное количество записей — например, 100 или число, указанное в max_items. Если число записей превышает это максимальное значение, можно отправить другой запрос, используя запись NextMarker из первого ответа, чтобы получить следующую страницу результатов | ||
| profile (добавлен в 1.6)
| нет | Использует профиль boto. Работает только с boto >= 2.24.0. | ||
| query | да |
| указывается действие запроса | |
| resource_id | нет | Идентификатор/ы указанного/ых ресурса/ов псевдонимы: resource_ids | ||
| security_token (добавлен в 1.6)
| нет | Токен безопасности AWS STS. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token | ||
| start_record_name | нет | Первое имя в лексикографическом порядке доменных имен, с которого команда list_command: record_sets должна начать перечисление | ||
| type | нет |
| Тип DNS-записи | |
| validate_certs (добавлен в 1.5)
| нет | да |
| Если установлено значение "нет", сертификаты SSL для версий boto >= 2.6.0 не будут проверены. |
Примеры
# Simple example of listing all hosted zones
- name: List all hosted zones
route53_facts:
query: hosted_zone
register: hosted_zones
# Getting a count of hosted zones
- name: Return a count of all hosted zones
route53_facts:
query: hosted_zone
hosted_zone_method: count
register: hosted_zone_count
- name: List the first 20 resource record sets in a given hosted zone
route53_facts:
profile: account_name
query: record_sets
hosted_zone_id: ZZZ1111112222
max_items: 20
register: record_sets
- name: List first 20 health checks
route53_facts:
query: health_check
health_check_method: list
max_items: 20
register: health_checks
- name: Get health check last failure_reason
route53_facts:
query: health_check
health_check_method: failure_reason
health_check_id: 00000000-1111-2222-3333-12345678abcd
register: health_check_failure_reason
- name: Retrieve reusable delegation set details
route53_facts:
query: reusable_delegation_set
delegation_set_id: delegation id
register: delegation_sets
- name: setup of example for using next_marker
route53_facts:
query: hosted_zone
max_items: 1
register: first_facts
- name: example for using next_marker
route53_facts:
query: hosted_zone
next_marker: "{{ first_facts.NextMarker }}"
max_items: 1
when: "{{ 'NextMarker' in first_facts }}"
Примечания
Примечание
- Если параметры не заданы в модуле, можно использовать следующие переменные окружения в порядке убывания приоритета
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
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Для получения помощи в разработке модулей, если вы так захотите, пожалуйста, прочитайте Информация о сообществе и участие в разработке, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/route53_facts_module.html