amazon.aws.route53_info модуль – Получает данные Route 53 с использованием методов AWS

access_key

aliases: aws_access_key_id, aws_access_key, ec2_access_key

string

Идентификатор ключа доступа AWS.

См. документацию AWS для получения дополнительной информации о токенах доступа https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys.

Переменные среды AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY также могут использоваться в порядке убывания предпочтения.

Параметры aws_access_key и profile являются взаимоисключающими.

Псевдоним aws_access_key_id был добавлен в релизе 5.1.0 для согласованности с AWS botocore SDK.

Псевдоним ec2_access_key устарел и будет удален в релизе после 2024-12-01.

Поддержка переменной среды EC2_ACCESS_KEY устарела и будет удалена в релизе после 2024-12-01.

aws_ca_bundle

path

Расположение пакета CA, используемого при проверке SSL-сертификатов.

Переменная среды AWS_CA_BUNDLE также может использоваться.

aws_config

dictionary

Словарь для изменения конфигурации botocore.

Параметры можно найти в документации AWS https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config.

change_id

string

Идентификатор запроса пакета изменений.

Значение, указанное здесь, — это значение, которое ChangeResourceRecordSets вернул в элементе Id при отправке запроса.

Требуется, если query=change.

debug_botocore_endpoint_logs

boolean

Использовать botocore.endpoint регистратор для анализа уникальных (а не общих) "resource:action" вызовов API, сделанных во время задачи, выводя набор в ключ resource_actions в результатах задачи. Используйте обратный вызов aws_resource_action для вывода в общий список, сделанный во время playbook.

Переменная среды ANSIBLE_DEBUG_BOTOCORE_LOGS также может использоваться.

Варианты:

• false ← (по умолчанию)
• true

delegation_set_id

string

Идентификатор набора делегирования зоны DNS.

dns_name

string

Первое имя в лексикографическом порядке доменных имен, с которого команда list_command должна начать перечисление.

endpoint_url

aliases: ec2_url, aws_endpoint_url, s3_url

string

URL для подключения вместо стандартных конечных точек AWS. Хотя это может использоваться для подключения к другим совместимым с AWS службам, коллекции amazon.aws и community.aws тестируются только с AWS.

Переменные среды AWS_URL или EC2_URL также могут использоваться в порядке убывания предпочтения.

Псевдонимы ec2_url и s3_url устарели и будут удалены в релизе после 2024-12-01.

Поддержка переменной среды EC2_URL устарела и будет удалена в релизе после 2024-12-01.

health_check_id

string

Идентификатор проверки работоспособности.

Требуется, если query установлено в health_check и health_check_method установлено в details или status или failure_reason.

health_check_method

string

Используется вместе с query: health_check. Позволяет отображать детали, подсчеты или теги различных деталей проверки работоспособности.

Варианты:

• "list" ← (по умолчанию)
• "details"
• "status"
• "failure_reason"
• "count"
• "tags"

hosted_zone_id

string

Идентификатор зоны размещения зоны DNS.

Требуется, если query установлено в hosted_zone и hosted_zone_method установлено в details.

Требуется, если query установлено в record_sets.

hosted_zone_method

string

Используется вместе с query: hosted_zone. Позволяет отображать детали, подсчеты или теги различных деталей зоны размещения.

Варианты:

• "details"
• "list" ← (по умолчанию)
• "list_by_name"
• "count"
• "tags"

max_items

integer

Максимальное количество элементов для возврата для различных запросов get/list.

next_marker

string

Некоторые запросы, такие как list_command: hosted_zones, вернут максимальное количество записей — например, 100 или число, указанное max_items. Если количество записей превышает этот максимум, можно отправить другой запрос, используя запись NextMarker из первого ответа, чтобы получить следующую страницу результатов.

profile

aliases: aws_profile

string

Именованный профиль AWS для использования для аутентификации.

См. документацию AWS для получения дополнительной информации об именованных профилях https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html.

Переменная среды AWS_PROFILE также может использоваться.

Параметр profile является взаимоисключающим с параметрами aws_access_key, aws_secret_key и security_token.

query

строка / обязательно

Определяет действие запроса.

Варианты:

• "change"
• "checker_ip_range"
• "health_check"
• "hosted_zone"
• "record_sets"
• "reusable_delegation_set"

region

псевдонимы: aws_region, ec2_region

строка

AWS регион для использования.

Для глобальных сервисов, таких как IAM, Route53 и CloudFront, region игнорируется.

Также могут использоваться переменные окружения AWS_REGION или EC2_REGION.

Дополнительную информацию см. в документации Amazon AWS по адресу http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region.

Псевдоним ec2_region устарел и будет удалён в релизе после 2024-12-01

Поддержка переменной окружения EC2_REGION устарела и будет удалена в релизе после 2024-12-01.

resource_id

псевдонимы: resource_ids

список / элементы=строка

Идентификатор/ы указанного/ых ресурса/ов.

Требуется, если query=health_check и health_check_method=tags.

Требуется, если query=hosted_zone и hosted_zone_method=tags.

secret_key

псевдонимы: aws_secret_access_key, aws_secret_key, ec2_secret_key

строка

Секретный ключ доступа к AWS.

Дополнительную информацию о маркерах доступа см. в документации AWS по адресу https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys.

Переменные окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY, или EC2_SECRET_KEY также могут быть использованы в порядке убывания приоритета.

Параметры secret_key и profile взаимоисключающие.

Псевдоним aws_secret_access_key был добавлен в релизе 5.1.0 для согласованности с SDK botocore AWS.

Псевдоним ec2_secret_key устарел и будет удалён в релизе после 2024-12-01.

Поддержка переменной окружения EC2_SECRET_KEY устарела и будет удалена в релизе после 2024-12-01.

session_token

псевдонимы: aws_session_token, security_token, aws_security_token, access_token

строка

Токен сессии AWS STS для использования с временными учетными данными.

Дополнительную информацию о маркерах доступа см. в документации AWS по адресу https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys.

Переменные окружения AWS_SESSION_TOKEN, AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN также могут быть использованы в порядке убывания приоритета.

Параметры security_token и profile взаимоисключающие.

Псевдонимы aws_session_token и session_token были добавлены в релизе 3.2.0, при этом параметр был переименован из security_token в session_token в релизе 6.0.0.

Псевдонимы security_token, aws_security_token и access_token устарели и будут удалены в релизе после 2024-12-01.

Поддержка переменных окружения EC2_SECRET_KEY и AWS_SECURITY_TOKEN устарела и будет удалена в релизе после 2024-12-01.

start_record_name

строка

Первое имя в лексикографическом порядке имён доменов, с которого вы хотите начать перечисление с помощью команды list_command: record_sets.

type

строка

Тип DNS записи.

Варианты:

• "A"
• "CNAME"
• "MX"
• "AAAA"
• "TXT"
• "PTR"
• "SRV"
• "SPF"
• "CAA"
• "NS"
• "NAPTR"
• "SOA"
• "DS"

validate_certs

логический

Если установлено в false, сертификаты SSL не будут проверены при взаимодействии с API AWS.

Установление validate_certs=false настоятельно не рекомендуется; вместо этого рассмотрите возможность установки aws_ca_bundle.

Варианты:

• false
• true ← (по умолчанию)

checker_ip_ranges

список / элементы=строка

добавлен в community.aws 4.1.0

Список диапазонов IP-адресов в формате CIDR для контроллеров работоспособности Amazon Route 53.

Возвращается: когда query=checker_ip_range

CheckerIpRanges

список / элементы=строка

Устаревший список диапазонов IP-адресов в формате CIDR (с использованием CamelCase) для контроллеров работоспособности Amazon Route 53. \ Этот список содержит те же элементы/параметры, что и его версия со строчными буквами (snake_case), упомянутая выше. \ Это поле устарело и будет удалено в релизе версии 6.0.0.

Возвращается: когда query=checker_ip_range

delegation_sets

список / элементы=словарь

добавлен в community.aws 4.1.0

Список словарей, содержащих информацию о наборах делегирования, которые можно использовать повторно.

Возвращается: когда query=reusable_delegation_set

DelegationSets

список / элементы=словарь

Устаревший список словарей (с использованием CamelCase), содержащих информацию о наборах делегирования, которые можно использовать повторно. \ Этот список содержит те же элементы/параметры, что и его версия со строчными буквами (snake_case), упомянутая выше. \ Это поле устарело и будет удалено в релизе версии 6.0.0.

Возвращается: когда query=reusable_delegation_set

health_check

словарь

добавлен в community.aws 4.1.0

Словарь с деталями проверки работоспособности Route53, возвращённый методом get_health_check в boto3.

Возвращается: когда query=health_check и health_check_method=details

caller_reference

строка

Уникальная строка, которую вы указали при создании проверки работоспособности.

Возвращается: успешно

Пример: "01d0db12-x0x9-12a3-1234-0z000z00zz0z"

health_check_config

словарь

Словарь, содержащий подробную информацию о проверке работоспособности.

Возвращается: успешно

disabled

булево

Указывает, следует ли Route53 прекратить выполнение проверок работоспособности на целевом узле.

Возвращается: успешно

Пример: false

enable_sni

булево

Указывает, следует ли Route53 отправлять значение FullyQualifiedDomainName на целевой узел в сообщении client_hello во время согласования TLS.

Возвращается: успешно

Пример: true

failure_threshold

целое число

Количество последовательных проверок работоспособности, которые должен пройти/не пройти целевой узел, чтобы Route53 изменил текущий статус целевого узла.

Возвращается: успешно

Пример: 3

fully_qualified_domain_name

строка

Полное доменное имя целевого узла, на котором Route53 выполняет проверки работоспособности.

Возвращается: успешно

Пример: "hello"

inverted

булево

Указывает, следует ли Route53 инвертировать статус проверки работоспособности.

Возвращается: успешно

Пример: false

ip_address

строка

IP-адрес (IPv4/IPv6) целевого узла, на котором Route53 должна выполнять проверки работоспособности.

Возвращается: успешно

Пример: "192.0.2.44"

measure_latency

булево

Указывает, следует ли Route53 измерять задержку между контроллерами работоспособности в нескольких регионах AWS и целевым узлом.

Возвращается: успешно

Пример: false

port

целое число

Порт целевого узла, на котором Route53 должна выполнять проверки работоспособности.

Возвращается: успешно

Пример: 80

request_interval

целое число

Количество секунд между моментом, когда Route53 получает ответ от целевого узла, и отправкой следующего запроса на проверку работоспособности.

Возвращается: успешно

Пример: 30

resource_path

string

Путь, который Route53 запрашивает при выполнении проверок работоспособности.

Возвращается: успех

Пример: "/welcome.html"

search_string

string

Строка, которую Route53 использует для поиска в теле ответа от указанного ресурса.

Возвращается: успех

Пример: "test-string-to-match"

type

string

Тип проверки работоспособности.

Возвращается: успех

Пример: "HTTPS"

health_check_version

string

Версия проверки работоспособности.

Возвращается: успех

Пример: "1"

id

string

Идентификатор, назначенный Amazon Route 53 проверке работоспособности при создании.

Возвращается: успех

Пример: "12345cdc-2cc4-1234-bed2-123456abc1a2"

health_check_observations

list / elements=dictionary

added in amazon.aws 5.4.0

Словарь данных о проверке работоспособности Route53, возвращаемый get_health_check_status и get_health_check_last_failure_reason в boto3.

Возвращается: при query=health_check и health_check_method=status или health_check_method=failure_reason

ip_address

string

IP-адрес проверяющего работоспособности Amazon Route 53, который предоставил причину ошибки в StatusReport.

Возвращается: успех

Пример: "12.345.67.89"

region

string

Регион проверяющего работоспособности Amazon Route 53, который предоставил статус в StatusReport.

Возвращается: успех

Пример: "us-west-1"

status_report

dictionary

Сложный тип, содержащий последнюю причину ошибки и время неудачной проверки работоспособности.

Возвращается: успех

checked_time

string

Дата и время выполнения проверки работоспособности проверяющим работоспособности в формате ISO 8601 и по Гринвичу (UTC).

Возвращается: успех

Пример: "2023-03-08T23:10:08.452000+00:00"

status

string

Описание состояния конечной точки проверки работоспособности, как сообщает один из проверяющих работоспособности Amazon Route 53.

Возвращается: успех

Пример: "Failure: Resolved IP: 12.345.67.89. The connection was closed by the endpoint."

health_checks

list / elements=dictionary

added in community.aws 4.0.0

Список проверок работоспособности Route 53, возвращаемый list_health_checks в boto3.

Возвращается: при query=health_check

caller_reference

string

Уникальная строка, указанная при создании проверки работоспособности.

Возвращается: успех

Пример: "01d0db12-x0x9-12a3-1234-0z000z00zz0z"

health_check_config

dictionary

Словарь, содержащий подробную информацию об одной проверке работоспособности.

Возвращается: успех

disabled

boolean

Указывает, должна ли Route53 прекратить выполнение проверок работоспособности конечной точки.

Возвращается: успех

Пример: false

enable_sni

boolean

Указывает, должна ли Route53 отправлять значение FullyQualifiedDomainName на конечную точку в сообщении client_hello во время TLS-переговоров.

Возвращается: успех

Пример: true

failure_threshold

integer

Количество последовательных проверок работоспособности, которые конечная точка должна пройти/не пройти, чтобы Route 53 изменил текущий статус конечной точки.

Returned: success

Sample: 3

fully_qualified_domain_name

string

Полностью квалифицированное доменное имя DNS конечной точки, на которой Route53 выполняет проверки работоспособности.

Returned: success

Sample: "hello"

inverted

boolean

Должен ли Route53 инвертировать статус проверки работоспособности.

Returned: success

Sample: false

ip_address

string

IP-адрес IPv4/IPv6 конечной точки, на которой Route53 должен выполнять проверки работоспособности.

Returned: success

Sample: "192.0.2.44"

measure_latency

boolean

Должен ли Route53 измерять задержку между контроллерами работоспособности в нескольких регионах AWS и конечной точкой.

Returned: success

Sample: false

port

integer

Порт конечной точки, на которой Route53 должен выполнять проверки работоспособности.

Returned: success

Sample: 80

request_interval

integer

Количество секунд между моментом получения Route53 ответа от конечной точки и следующим запросом проверки работоспособности.

Returned: success

Sample: 30

resource_path

string

Путь, который запрашивает Route53 при выполнении проверок работоспособности.

Returned: success

Sample: "/welcome.html"

search_string

string

Строка, которую Route 53 использует для поиска в ответе от указанного ресурса.

Returned: success

Sample: "test-string-to-match"

type

string

Тип проверки работоспособности.

Returned: success

Sample: "HTTPS"

health_check_version

string

Версия проверки работоспособности.

Returned: success

Sample: "1"

id

string

Идентификатор, назначенный Amazon Route53 проверке работоспособности во время создания.

Returned: success

Sample: "12345cdc-2cc4-1234-bed2-123456abc1a2"

HealthCheck

dictionary

Устаревший словарь Route53 сведений о проверке работоспособности, возвращаемый get_health_check в boto3. \ Этот словарь содержит те же элементы/параметры, что и его версия со snake_case, упомянутая выше. \ Это поле устарело и будет удалено в версии 6.0.0.

Returned: when query=health_check and health_check_method=details

HealthChecks

list / elements=dictionary

Устаревший список проверок работоспособности Route53, возвращаемый list_health_checks в boto3. \ Этот список содержит те же элементы/параметры, что и его версия со snake_case, упомянутая выше. \ Это поле устарело и будет удалено в версии 6.0.0.

Returned: when query=health_check

hosted_zones

list / elements=dictionary

added in community.aws 4.0.0

Список зон размещения, возвращаемый list_hosted_zones в boto3.

Returned: when query=hosted_zone

caller_reference

string

Значение, указанное для CallerReference во время создания зоны размещения.

Returned: success

Sample: "01d0db12-x0x9-12a3-1234-0z000z00zz0z"

config

словарь

Словарь, содержащий элементы Comment и PrivateZone.

Возвращаемое значение: успех

comment

строка

Комментарии, включённые в зону размещения.

Возвращаемое значение: успех

Пример: "HostedZone created by Route53 Registrar"

private_zone

логическое значение

Значение, указывающее, является ли это частной зоной размещения или нет.

Возвращаемое значение: успех

Пример: false

id

строка

Идентификатор зоны размещения, назначенный Amazon Route53 при создании зоны размещения.

Возвращаемое значение: успех

Пример: "/hostedzone/Z01234567AB1234567890"

name

строка

Имя домена.

Возвращаемое значение: успех

Пример: "example.io"

resource_record_set_count

целое число

Количество записей набора ресурсов в зоне размещения.

Возвращаемое значение: успех

Пример: 3

HostedZones

список / элементы=словарь

Устаревший список зон размещения с использованием CamelCase, возвращаемый функцией list_hosted_zones в boto3. \ Этот список содержит те же элементы/параметры, что и его версия со snake_case, упомянутая выше. \ Это поле устарело и будет удалено в версии 6.0.0.

Возвращаемое значение: когда query=hosted_zone

resource_record_sets

список / элементы=словарь

добавлен в community.aws 4.0.0

Список записей набора ресурсов, возвращаемых функцией list_resource_record_sets в boto3.

Возвращаемое значение: когда query=record_sets

geo_location

словарь

Указанное географическое местоположение, на которое Route53 реагирует на основе местоположения.

Возвращаемое значение: успех

continent_code

строка

Двухбуквенный код континента.

Возвращаемое значение: успех

Пример: "NA"

country_code

строка

Двухбуквенный код страны.

Возвращаемое значение: успех

Пример: "US"

subdivision_code

строка

Двухбуквенный код штата США

Возвращаемое значение: успех

Пример: "NY"

name

строка

Имя записи в указанной зоне размещения.

Возвращаемое значение: успех

Пример: "www.example.com"

resource_records

список / элементы=словарь

Информация о записях ресурсов.

Возвращаемое значение: успех

value

строка

Текущее или новое значение записи DNS.

Возвращаемое значение: успех

Пример: "ns-12.awsdns-34.com."

set_identifier

строка

Идентификатор, который отличает несколько записей набора ресурсов, имеющих одинаковую комбинацию имени и типа.

Возвращаемое значение: успех

Пример: "abcd"

ttl

целое число

Время жизни кэша записи ресурса (TTL) в секундах.

Возвращаемое значение: успех

Пример: 60

тип

строка

Тип DNS-записи.

Возвращается: при успехе

Пример: "A"

ResourceRecordSets

список / элементы=словарь

Устаревший список записей ресурса с использованием CamelCase, возвращаемый функцией list_resource_record_sets в boto3. \ Этот список содержит те же элементы/параметры, что и его версия со snake_case, упомянутая выше. \ Это поле устарело и будет удалено в версии 6.0.0.

Возвращается: когда query=record_sets