list-resource-record-sets

Описание

Отображает записи набора ресурсов в указанной зоне размещения.

ListResourceRecordSets возвращает до 300 записей набора ресурсов за раз в ASCII порядке, начиная с позиции, указанной элементами name и type.

Порядок сортировки

ListResourceRecordSets сортирует результаты сначала по имени DNS, с обратным порядком меток, например:

com.example.www.

Обратите внимание на конечную точку, которая может изменить порядок сортировки, когда имя записи содержит символы, которые появляются до . (десятичное 46) в таблице ASCII. К этим символам относятся следующие: ! " # $ % & ' ( ) * + , -

Когда несколько записей имеют одинаковое имя DNS, ListResourceRecordSets сортирует результаты по типу записи.

Указание, с какой записи начать перечисление

Можно использовать элементы Name и Type для указания записи набора ресурсов, с которой начинается список:

Если вы не указываете Name или Type

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

Если вы указываете Name, но не Type

Результаты начинаются с первой записи набора ресурсов в списке, имя которой больше или равно Name.

Если вы указываете Type, но не Name

Amazon Route 53 возвращает ошибку InvalidInput.

Если вы указываете и Name, и Type

Результаты начинаются с первой записи набора ресурсов в списке, имя которой больше или равно Name, и тип которой больше или равен Type.

Примечание

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

Записи набора ресурсов, которые находятся в статусе PENDING

Этот действие возвращает последнюю версию записей. Это включает записи, которые находятся в статусе PENDING, и которые еще не доступны на всех серверах DNS Route 53.

Изменение записей набора ресурсов

Чтобы убедиться, что вы получаете точный список записей набора ресурсов для зоны размещения в определенный момент времени, не отправляйте запрос ChangeResourceRecordSets во время просмотра результатов запроса ListResourceRecordSets. В противном случае некоторые страницы могут отображать результаты без последних изменений, а другие страницы отобразят результаты с последними изменениями.

Отображение следующей страницы результатов

Если команда ListResourceRecordSets возвращает более одной страницы результатов, значение IsTruncated равно true. Чтобы отобразить следующую страницу результатов, получите значения NextRecordName, NextRecordType и NextRecordIdentifier (если есть) из ответа. Затем отправьте еще один запрос ListResourceRecordSets и укажите эти значения для StartRecordName, StartRecordType и StartRecordIdentifier.

См. также: AWS API Documentation

list-resource-record-sets — это операция с постраничным отображением. Для получения всего набора данных результатов могут быть выпущены несколько API-запросов. Вы можете отключить постраничное отображение, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничным отображением, аргумент --query должен извлекать данные из результатов следующих выражений запроса: ResourceRecordSets

Синопсис

  list-resource-record-sets
--hosted-zone-id <value>
[--max-items <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--hosted-zone-id (строка)

ID зоны размещения, содержащей записи набора ресурсов, которые вы хотите отобразить.

--max-items (строка)

Общее количество элементов, которые нужно вернуть в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Чтобы продолжить постраничное отображение, укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken непосредственно за пределами AWS CLI.

Примеры использования см. в разделе Постраничное отображение в Руководстве пользователя AWS Command Line Interface.

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, указанному в --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Маркер для указания точки начала постраничного отображения. Это NextToken из ранее усечённого ответа.

Примеры использования см. в разделе Постраничное отображение в Руководстве пользователя AWS Command Line Interface.

--page-size (строка)

Размер каждой страницы для вызова AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, извлекая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.

Примеры использования см. в разделе Постраничное отображение в Руководстве пользователя AWS Command Line Interface.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки API-запроса. Если не указано значение или значение input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано значение yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если указано значение output, он проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (булево)

Включить отладочную регистрацию.

--endpoint-url (строка)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение по умолчанию по проверке SSL-сертификатов.

--no-paginate (булево)

Отключить автоматическое постраничное отображение. Если автоматическое постраничное отображение отключено, AWS CLI сделает только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команды.

json
text
table
yaml
yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определённый профиль из файла с вашими учетными данными.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

on
off
auto

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (строка)

Файл сертификата CA для использования при проверке SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут представлены как закодированная в base64 строка. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, сопоставляющегося с двоичным блоком, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (булево)

Отключить кли-паджер для вывода.

--cli-auto-prompt (булево)

Автоматически запросить параметры CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запросы параметров CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

За исключением случаев, когда указано иное, все примеры используют правила цитирования, подобные unix-подобным. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. Подробнее см. в разделе Использование кавычек со строками в Руководстве пользователя AWS CLI.

Чтобы перечислить записи набора ресурсов в зоне размещения

Следующая list-resource-record-sets команда отображает сводную информацию о первых 100 записях набора ресурсов в указанной зоне размещения:

aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE

Если зона размещения содержит более 100 записей набора ресурсов или если вы хотите перечислить их группами меньше 100, включите параметр --maxitems. Например, чтобы перечислить записи набора ресурсов по одной, используйте следующую команду:

aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE --max-items 1

Чтобы просмотреть информацию о следующей записи набора ресурсов в зоне размещения, возьмите значение NextToken из ответа на предыдущую команду и включите его в параметр --starting-token, например:

aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE --max-items 1 --starting-token Z3M3LMPEXAMPLE

Чтобы просмотреть все записи набора ресурсов определённого имени, используйте параметр --query для их фильтрации. Например:

aws route53 list-resource-record-sets --hosted-zone-id Z2LD58HEXAMPLE --query "ResourceRecordSets[?Name == 'example.domain.']"

Вывод

ResourceRecordSets -> (список)

Информация о нескольких наборах записей ресурсов.

(структура)

Информация о наборе записей ресурсов для создания или удаления.

Имя -> (строка)

Для запросов типа ChangeResourceRecordSets имя записи, которую вы хотите создать, обновить или удалить. Для ответов типа ListResourceRecordSets имя записи в указанной зоне размещения.

Только ChangeResourceRecordSets

Введите полное доменное имя, например, www.example.com . Вы можете необязательно добавить конечную точку. Если вы опустите конечную точку, Amazon Route 53 предполагает, что указанное вами доменное имя полное. Это означает, что Route 53 рассматривает www.example.com (без конечной точки) и www.example.com. (с конечной точкой) как идентичные.

Сведения о том, как указать символы, отличные от a-z , 0-9 и - (тире), и как указать международные доменные имена, см. в разделе DNS Domain Name Format в руководстве разработчика Amazon Route 53.

Вы можете использовать символ подстановки (*) для замены самого левого метки в доменном имени, например, *.example.com . Обратите внимание на следующее:

Символ * должен заменять всю метку. Например, вы не можете указать *prod.example.com или prod*.example.com .
Символ * не может заменять какие-либо промежуточные метки, например, marketing.*.example.com.
Если вы включите * в любой позиции, кроме самой левой метки в доменном имени, DNS рассматривает его как символ * (ASCII 42), а не как символ подстановки.

Предупреждение

Вы не можете использовать символ подстановки * для наборов записей ресурсов с типом NS.

Тип -> (строка)

Тип записи DNS. Сведения о различных типах записей и о том, как данные кодируются для них, см. в разделе Поддерживаемые типы записей ресурсов DNS в руководстве разработчика Amazon Route 53.

Допустимые значения для основных наборов записей ресурсов: A | AAAA | CAA | CNAME | DS |MX | NAPTR | NS | PTR | SOA | SPF | SRV | TXT | TLSA | SSHFP | SVCB | HTTPS

Значения для наборов записей ресурсов с весом, задержкой, географическим положением и резервированием: A | AAAA | CAA | CNAME | MX | NAPTR | PTR | SPF | SRV | TXT | TLSA | SSHFP | SVCB | HTTPS. При создании группы наборов записей ресурсов с весом, задержкой, географическим положением или резервированием укажите одинаковое значение для всех наборов записей ресурсов в группе.

Допустимые значения для наборов записей ресурсов с многозначными ответами: A | AAAA | MX | NAPTR | PTR | SPF | SRV | TXT | CAA | TLSA | SSHFP | SVCB | HTTPS

Примечание

Записи SPF ранее использовались для проверки подлинности отправителя электронных сообщений. Однако мы больше не рекомендуем создавать наборы записей ресурсов, для которых значение Type равно SPF . RFC 7208, «Sender Policy Framework (SPF) для авторизации использования доменов в электронной почте, версия 1», был обновлён, чтобы указать, что «…[его] существование и механизм, определенные в [RFC4408], привели к некоторым проблемам межсетевой совместимости. Соответственно, его использование больше не подходит для SPF версии 1; реализации не должны его использовать». В RFC 7208 см. раздел 14.1, Тип записи DNS SPF.

Значения для наборов записей ресурсов алиасов:

Пользовательские региональные API и оптимизированные для кэша API Amazon API Gateway: A
Распределения CloudFront: A Если для распределения включён IPv6, создайте два набора записей ресурсов для маршрутизации трафика в ваше распределение, одно со значением A и одно со значением AAAA .
Среда Amazon API Gateway с регионализированным поддоменом : A
Балансировщики нагрузки ELB: A | AAAA
Ведра Amazon S3: A
Интерфейсные VPC-точки конечных узлов Amazon Virtual Private Cloud A
Другой набор записей ресурсов в этой зоне размещения: Укажите тип набора записей ресурсов, для которого вы создаёте алиас. Поддерживаются все значения, кроме NS и SOA .

Примечание

Если вы создаёте запись алиаса с тем же именем, что и зона размещения (также известна как вершина зоны), вы не можете маршрутизировать трафик в запись, для которой значение Type равно CNAME . Это связано с тем, что запись алиаса должна иметь тот же тип, что и запись, в которую вы направляете трафик, а создание записи CNAME для вершины зоны не поддерживается даже для записи алиаса.

SetIdentifier -> (строка)

Наборы записей ресурсов, имеющие политику маршрутизации, отличную от простой: Идентификатор, отличающий несколько наборов записей ресурсов, имеющих то же сочетание имени и типа, например, несколько наборов записей ресурсов с весом, имеющих имя acme.example.com и тип A. В группе наборов записей ресурсов с одинаковым именем и типом значение SetIdentifier должно быть уникальным для каждого набора записей ресурсов.

Сведения о политиках маршрутизации см. в разделе Выбор политики маршрутизации в руководстве разработчика Amazon Route 53.

Вес -> (целое)

Только наборы записей ресурсов с весом: Среди наборов записей ресурсов с одинаковым сочетанием имени DNS и типа значение, определяющее долю запросов DNS, на которые Amazon Route 53 отвечает, используя текущий набор записей ресурсов. Route 53 вычисляет сумму весов для наборов записей ресурсов, имеющих одинаковое сочетание имени DNS и типа. Затем Route 53 отвечает на запросы на основе отношения веса ресурса к общей сумме. Обратите внимание на следующее:

Для каждого набора записей ресурсов с весом необходимо указать значение элемента Weight .
Вы можете указать только один ResourceRecord на набор записей ресурсов с весом.
Вы не можете создавать наборы записей ресурсов с задержкой, резервированием или географическим положением, имеющие одинаковые значения для элементов Name и Type с наборами записей ресурсов с весом.
Вы можете создать не более 100 наборов записей ресурсов с весом, имеющих одинаковые значения для элементов Name и Type .
Для наборов записей ресурсов с весом (но не для наборов записей ресурсов с алиасом с весом), если вы установите Weight в 0 для набора записей ресурсов, Route 53 никогда не отвечает на запросы с соответствующим значением для этого набора записей ресурсов. Однако если вы установите Weight в 0 для всех наборов записей ресурсов, имеющих одинаковое сочетание имени DNS и типа, трафик маршрутизируется ко всем ресурсам с равной вероятностью. Эффект установки Weight в 0 отличается при привязке проверок работоспособности к наборам записей ресурсов с весом. Дополнительную информацию см. в разделе Параметры настройки маршрутизации Route 53 Active-Active и Active-Passive Failover в руководстве разработчика Amazon Route 53.

Регион -> (строка)

Только для наборов записей ресурсов на основе задержки: Регион Amazon EC2, в котором вы создали ресурс, на который ссылается этот набор записей ресурсов. Ресурс обычно представляет собой ресурс Amazon Web Services, такой как экземпляр EC2 или балансировщик нагрузки ELB, и обозначается IP-адресом или доменным именем DNS, в зависимости от типа записи.

Когда Amazon Route 53 получает запрос DNS для доменного имени и типа, для которого вы создали наборы записей ресурсов на основе задержки, Route 53 выбирает набор записей ресурсов на основе задержки с наименьшей задержкой между конечным пользователем и связанным регионом Amazon EC2. Затем Route 53 возвращает значение, связанное с выбранным набором записей ресурсов.

Обратите внимание на следующее:

Вы можете указать только одно ResourceRecord на набор записей ресурсов на основе задержки.
Вы можете создать только один набор записей ресурсов на основе задержки для каждого региона Amazon EC2.
Вам не нужно создавать наборы записей ресурсов на основе задержки для всех регионов Amazon EC2. Route 53 выберет регион с наилучшей задержкой из среди регионов, для которых вы создали наборы записей ресурсов на основе задержки.
Вы не можете создавать наборы записей ресурсов, не являющиеся наборами записей ресурсов на основе задержки, имеющие одинаковые значения для элементов Name и Type с наборами записей ресурсов на основе задержки.

GeoLocation -> (структура)

Наборы записей ресурсов геолокации только: Сложный тип, позволяющий контролировать, как Amazon Route 53 отвечает на запросы DNS в зависимости от географического происхождения запроса. Например, если вы хотите, чтобы все запросы из Африки маршрутизировались на веб-сервер с IP-адресом 192.0.2.111 , создайте набор записей ресурсов с Type A и ContinentCode AF .

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

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

Значение * в элементе CountryCode соответствует всем географическим местоположениям, которые не указаны в других наборах записей ресурсов геолокации, имеющих одинаковые значения для элементов Name и Type.

Предупреждение

Геолокация работает, сопоставляя IP-адреса с местоположениями. Однако некоторые IP-адреса не сопоставлены с географическими местоположениями, поэтому даже если вы создадите наборы записей ресурсов геолокации, охватывающие все семь континентов, Route 53 получит некоторые запросы DNS из мест, которые он не может идентифицировать. Мы рекомендуем создать набор записей ресурсов, для которого значение CountryCode равно * . Две группы запросов маршрутизируются на ресурс, который вы указали в этой записи: запросы, которые поступают из местоположений, для которых вы не создали наборы записей ресурсов геолокации, и запросы от IP-адресов, которые не сопоставлены с местоположением. Если вы не создадите набор записей ресурсов *, Route 53 вернет ответ «нет ответа» для запросов из этих местоположений.

Вы не можете создать наборы записей ресурсов, не относящиеся к геолокации, которые имеют одинаковые значения для элементов Name и Type с наборами записей ресурсов геолокации.

ContinentCode -> (строка)

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

Amazon Route 53 поддерживает следующие коды континентов:

AF : Африка
AN : Антарктида
AS : Азия
EU : Европа
OC : Океания
NA : Северная Америка
SA : Южная Америка

Ограничение: Указание ContinentCode с CountryCode или SubdivisionCode возвращает ошибку InvalidInput.

CountryCode -> (строка)

Для наборов записей ресурсов геолокации двухбуквенный код страны.

Amazon Route 53 использует двухбуквенные коды стран, указанные в ISO стандарт 3166-1 alpha-2.

Route 53 также поддерживает код страны UA для Украины.

SubdivisionCode -> (строка)

Для наборов записей ресурсов геолокации двухбуквенный код штата США. Route 53 не поддерживает другие значения для SubdivisionCode. Список сокращений штатов см. в приложении B: Двухбуквенные сокращения штатов и владений на веб-сайте почтовой службы США.

Если вы укажете subdivisioncode, вы также должны указать US для CountryCode.

Failover -> (строка)

Наборы записей ресурсов Failover только: Для настройки failover добавьте элемент Failover в два набора записей ресурсов. Для одного набора записей ресурсов вы указываете PRIMARY в качестве значения для Failover; для другого набора записей ресурсов вы указываете SECONDARY. Кроме того, вы включаете элемент HealthCheckId и указываете проверку работоспособности, которую вы хотите, чтобы Amazon Route 53 выполнил для каждого набора записей ресурсов.

За исключением случаев, когда указано иное, следующие возможности failover предполагают, что вы включили элемент HealthCheckId в оба набора записей ресурсов:

Когда основной набор записей ресурсов работает нормально, Route 53 отвечает на запросы DNS с соответствующим значением из основного набора записей ресурсов независимо от состояния вторичного набора записей ресурсов.
Когда основной набор записей ресурсов неисправен, а вторичный набор записей ресурсов работает нормально, Route 53 отвечает на запросы DNS с соответствующим значением из вторичного набора записей ресурсов.
Когда вторичный набор записей ресурсов неисправен, Route 53 отвечает на запросы DNS с соответствующим значением из основного набора записей ресурсов независимо от состояния основного набора записей ресурсов.
Если вы опустите элемент HealthCheckId для вторичного набора записей ресурсов, и если основной набор записей ресурсов неисправен, Route 53 всегда отвечает на запросы DNS с соответствующим значением из вторичного набора записей ресурсов. Это верно независимо от состояния связанного конечного пункта.

Вы не можете создать наборы записей ресурсов, не относящиеся к failover, которые имеют одинаковые значения для элементов Name и Type, как наборы записей ресурсов failover.

Для наборов записей ресурсов failover алиасов вы также должны включить элемент EvaluateTargetHealth и установить значение в true.

Дополнительную информацию о настройке failover для Route 53 см. в следующих разделах руководства разработчика Amazon Route 53:

Проверки работоспособности Route 53 и failover DNS
Настройка failover в частной зоне размещения

MultiValueAnswer -> (логическое)

Наборы записей ответов Multivalue только: Чтобы примерно равномерно распределить трафик по нескольким ресурсам, таким как веб-серверы, создайте одну запись ответа multivalue для каждого ресурса и укажите true для MultiValueAnswer. Обратите внимание на следующее:

Если вы связываете проверку работоспособности с набором записей ресурсов multivalue ответа, Amazon Route 53 отвечает на запросы DNS соответствующим IP-адресом только при нормальной работе проверки работоспособности.
Если вы не связываете проверку работоспособности с записью ответа multivalue, Route 53 всегда считает запись рабочей.
Route 53 отвечает на запросы DNS до восьми работоспособных записей; если у вас восемь или меньше работоспособных записей, Route 53 отвечает на все запросы DNS всеми работоспособными записями.
Если у вас более восьми работоспособных записей, Route 53 отвечает различным решателям DNS различными комбинациями работоспособных записей.
Когда все записи неисправны, Route 53 отвечает на запросы DNS до восьми неисправных записей.
Если ресурс становится недоступным после кеширования ответа решателем, клиентское программное обеспечение обычно пытается использовать другой IP-адрес из ответа.

Вы не можете создать записи алиасов multivalue ответа.

TTL -> (длинное)

Время жизни кэша записей ресурсов (TTL), в секундах. Обратите внимание на следующее:

Если вы создаете или обновляете набор записей ресурсов алиаса, опустите TTL. Amazon Route 53 использует значение TTL для целевого алиаса.
Если вы связываете этот набор записей ресурсов с проверкой работоспособности (если вы добавляете элемент HealthCheckId), мы рекомендуем указать TTL 60 секунд или меньше, чтобы клиенты быстро реагировали на изменения статуса работоспособности.
Все наборы записей ресурсов в группе наборов записей ресурсов с весами должны иметь одинаковое значение для TTL.
Если группа наборов записей ресурсов с весами включает один или несколько наборов записей ресурсов алиаса с весами, для которых целевой алиас — балансировщик нагрузки ELB, мы рекомендуем указать TTL 60 секунд для всех наборов записей ресурсов с весами без алиаса, имеющих то же имя и тип. Значения, отличные от 60 секунд (TTL для балансировщиков нагрузки), изменят эффект значений, которые вы указываете для Weight.

ResourceRecords -> (список)

Информация о записях ресурсов, которые нужно обработать.

Примечание

Если вы создаете набор записей ресурсов алиаса, опустите ResourceRecords.

(структура)

Информация, специфичная для записи ресурса.

Примечание

Если вы создаете набор записей ресурсов алиаса, опустите ResourceRecord.

Value -> (строка)

Текущее или новое значение записи DNS, не превышающее 4000 символов. В случае действия DELETE, если текущее значение не соответствует фактическому значению, возвращается ошибка. Описания формата Value для разных типов записей см. в разделе Поддерживаемые типы записей ресурсов DNS в Руководстве разработчика Amazon Route 53.

Вы можете указать более одного значения для всех типов записей, кроме CNAME и SOA.

Примечание

Если вы создаете набор записей ресурсов алиаса, опустите Value.

AliasTarget -> (структура)

Только для наборов записей ресурса с псевдонимом: Информация об ресурсе Amazon Web Services, например, о распределении CloudFront или ведре Amazon S3, на который вы хотите направить трафик.

Если вы создаете наборы записей ресурсов для частной зоны размещения, обратите внимание на следующее:

Вы не можете создать набор записей ресурса с псевдонимом в частной зоне размещения для перенаправления трафика на распределение CloudFront.
Дополнительную информацию о создании наборов записей ресурса с переключением резервного копирования в частной зоне размещения см. в разделе «Настройка резервного копирования в частной зоне размещения» в руководстве разработчика Amazon Route 53.

HostedZoneId -> (строка)

Только для наборов записей ресурсов с псевдонимом: Значение зависит от того, куда вы хотите направить трафик:

Настраиваемые региональные API и API с оптимизацией для кромки Amazon API Gateway

Укажите идентификатор зоны размещения для вашего API. Вы можете получить соответствующее значение, используя команду CLI get-domain-names :

Для региональных API укажите значение regionalHostedZoneId.
Для API с оптимизацией для кромки укажите значение distributionHostedZoneId.

Интерфейсный VPC-точку подключения Amazon Virtual Private Cloud

Укажите идентификатор зоны размещения для вашей точки подключения интерфейса. Вы можете получить значение HostedZoneId, используя команду CLI describe-vpc-endpoints.

Распределение CloudFront

Укажите Z2FDTNDATAQYW2.

Примечание

Наборы записей ресурса с псевдонимом для CloudFront не могут быть созданы в частной зоне.

Среда Elastic Beanstalk

Укажите идентификатор зоны размещения для региона, в котором вы создали среду. Среда должна иметь региональный домен. Список регионов и соответствующих идентификаторов зон размещения см. в разделе «Конечные точки и квоты Elastic Beanstalk» в «Общей справке Amazon Web Services».

Балансировщик нагрузки ELB

Укажите значение идентификатора зоны размещения для балансировщика нагрузки. Используйте следующие методы для получения идентификатора зоны размещения:

Раздел «Конечные точки и квоты Elastic Load Balancing» в «Общей справке Amazon Web Services»: используйте значение, соответствующее региону, в котором вы создали свой балансировщик нагрузки. Обратите внимание на то, что существуют отдельные столбцы для балансировщиков приложений и классических балансировщиков, а также для балансировщиков сети.
Консоль управления Amazon Web Services: перейдите на страницу Amazon EC2, выберите Балансировщики нагрузки в навигационной панели, выберите балансировщик и получите значение поля Зона размещения на вкладке Описание.
API Elastic Load Balancing: Используйте DescribeLoadBalancers для получения соответствующего значения. Дополнительную информацию см. в соответствующем руководстве:
- Классические балансировщики: используйте DescribeLoadBalancers для получения значения CanonicalHostedZoneNameId.
- Балансировщики приложений и сети: используйте DescribeLoadBalancers для получения значения CanonicalHostedZoneId.
CLI: Используйте describe-load-balancers для получения соответствующего значения. Дополнительную информацию см. в соответствующем руководстве:
- Классические балансировщики: используйте describe-load-balancers для получения значения CanonicalHostedZoneNameId.
- Балансировщики приложений и сети: используйте describe-load-balancers для получения значения CanonicalHostedZoneId.
Ускоритель Global Accelerator

Укажите Z2BJ6XQ5FK7U4H.

Ведро Amazon S3, настроенное как веб-сайт статического содержимого

Укажите идентификатор зоны размещения для региона, в котором вы создали ведро. Дополнительную информацию о допустимых значениях см. в таблице «Конечные точки веб-сайтов Amazon S3» в «Общей справке Amazon Web Services».

Другой набор записей ресурса Route 53 в вашей зоне размещения

Укажите идентификатор зоны размещения вашей зоны размещения. (Набор записей ресурса с псевдонимом не может ссылаться на набор записей ресурса в другой зоне размещения.)

DNSName -> (строка)

Только для наборов записей ресурсов с псевдонимом: Указываемое вами значение зависит от того, где вы хотите перенаправлять запросы:

Настраиваемые региональные API и API с оптимизацией для кромки Amazon API Gateway

Укажите соответствующее доменное имя для вашего API. Вы можете получить соответствующее значение, используя команду CLI get-domain-names:

Для региональных API укажите значение regionalDomainName.
Для API с оптимизацией для кромки укажите значение distributionDomainName. Это имя связанного распределения CloudFront, например, da1b2c3d4e5.cloudfront.net.

Примечание

Имя создаваемой записи должно соответствовать настраиваемому доменному имени вашего API, например, api.example.com.

Интерфейсный VPC-точку подключения Amazon Virtual Private Cloud

Введите конечную точку API для точки подключения интерфейса, например, vpce-123456789abcdef01-example-us-east-1a.elasticloadbalancing.us-east-1.vpce.amazonaws.com. Для API с оптимизацией для кромки это доменное имя соответствующего распределения CloudFront. Вы можете получить значение DnsName, используя команду CLI describe-vpc-endpoints.

Распределение CloudFront

Укажите доменное имя, назначенное CloudFront при создании вашего распределения.

Ваше распределение CloudFront должно включать альтернативное доменное имя, соответствующее имени набора записей ресурса. Например, если имя набора записей ресурса — acme.example.com, ваше распределение CloudFront должно включать acme.example.com в качестве одного из альтернативных доменных имен. Дополнительную информацию см. в разделе «Использование альтернативных доменных имен (CNAME)» в «Руководстве разработчика Amazon CloudFront».

Вы не можете создать набор записей ресурса в частной зоне размещения для перенаправления трафика на распределение CloudFront.

Примечание

Для записей с переключением резервного копирования с псевдонимом вы не можете указать распределение CloudFront как для первичной, так и для вторичной записи. Распределение должно включать альтернативное доменное имя, соответствующее имени записи. Однако первичная и вторичная записи имеют одинаковое имя, и вы не можете включить одно и то же альтернативное доменное имя в более чем одно распределение.

Среда Elastic Beanstalk

Если доменное имя вашей среды Elastic Beanstalk включает регион, в котором вы развернули среду, вы можете создать запись с псевдонимом, которая перенаправляет трафик в среду. Например, доменное имя my-environment.*us-west-2* .elasticbeanstalk.com — это регионализованное доменное имя.

Предупреждение

Для сред, созданных до начала 2016 года, доменное имя не включает регион. Чтобы направить трафик в эти среды, необходимо создать запись CNAME вместо записи с псевдонимом. Обратите внимание, что вы не можете создать запись CNAME для корневого доменного имени. Например, если ваше доменное имя example.com, вы можете создать запись, которая перенаправляет трафик для acme.example.com в вашу среду Elastic Beanstalk, но вы не можете создать запись, которая перенаправляет трафик для example.com в вашу среду Elastic Beanstalk.

Для сред Elastic Beanstalk с регионализованными поддоменами укажите атрибут CNAME для среды. Вы можете использовать следующие методы для получения значения атрибута CNAME:

Консоль управления Amazon Web Services: Дополнительную информацию о получении значения с помощью консоли см. в разделе «Использование настраиваемых доменов с Elastic Beanstalk» в «Руководстве разработчика Elastic Beanstalk».
API Elastic Beanstalk: Используйте действие DescribeEnvironments для получения значения атрибута CNAME. Дополнительную информацию см. в разделе DescribeEnvironments в «Справочнике по API Elastic Beanstalk».
CLI: Используйте команду describe-environments для получения значения атрибута CNAME. Дополнительную информацию см. в «Справочнике по командам CLI».

Балансировщик нагрузки ELB

Укажите доменное имя, связанное с балансировщиком нагрузки. Доменное имя можно получить, используя консоль управления Amazon Web Services, API ELB или CLI.

Консоль управления Amazon Web Services: перейдите на страницу EC2, выберите Балансировщики нагрузки в навигационной панели, выберите балансировщик, выберите вкладку Описание и получите значение поля Доменное имя. Если вы направляете трафик на классический балансировщик нагрузки, получите значение, начинающееся с dualstack. Если вы направляете трафик на другой тип балансировщика, получите значение, соответствующее типу записи, A или AAAA.
API Elastic Load Balancing: Используйте DescribeLoadBalancers для получения значения DNSName. Дополнительную информацию см. в соответствующем руководстве:
- Классические балансировщики: DescribeLoadBalancers
- Балансировщики приложений и сети: DescribeLoadBalancers
CLI: Используйте describe-load-balancers для получения значения DNSName. Дополнительную информацию см. в соответствующем руководстве:
- Классические балансировщики: describe-load-balancers
- Балансировщики приложений и сети: describe-load-balancers
Ускоритель Global Accelerator

Укажите доменное имя вашего ускорителя:

API Global Accelerator: Для получения доменного имени используйте DescribeAccelerator.
CLI: Для получения доменного имени используйте describe-accelerator.

Ведро Amazon S3, настроенное как веб-сайт статического содержимого

Укажите доменное имя конечной точки веб-сайта Amazon S3, в котором вы создали ведро, например, s3-website.us-east-2.amazonaws.com. Дополнительную информацию о допустимых значениях см. в таблице «Конечные точки веб-сайтов Amazon S3» в «Общей справке Amazon Web Services». Дополнительную информацию об использовании ведер S3 для веб-сайтов см. в руководстве разработчика Amazon Route 53 «Начало работы с Amazon Route 53».

Другой набор записей ресурса Route 53

Укажите значение элемента Name для набора записей ресурса в текущей зоне размещения.

Примечание

Если вы создаете запись с псевдонимом, имеющую то же имя, что и зона размещения (известная как вершина зоны), вы не можете указать доменное имя для записи, для которой значение Type равно CNAME. Это связано с тем, что запись с псевдонимом должна иметь тот же тип, что и запись, на которую вы направляете трафик, и создание записи CNAME для вершины зоны не поддерживается даже для записи с псевдонимом.

EvaluateTargetHealth -> (логическое)

Применимо только к ресурсным записям alias, failover alias, geolocation alias, latency alias и weighted alias: Когда EvaluateTargetHealth имеет значение true, ресурсная запись alias наследует состояние работоспособности связанного ресурса Amazon Web Services, такого как балансировщик нагрузки ELB или другая ресурсная запись в зоне размещения.

Обратите внимание на следующее:

Дистрибутивы CloudFront

Вы не можете установить EvaluateTargetHealth в значение true, когда целевой alias — дистрибутив CloudFront.

Окружения Elastic Beanstalk с регионализованными доменными именами

Если вы указываете окружение Elastic Beanstalk в DNSName, а в окружении есть балансировщик нагрузки ELB, Elastic Load Balancing направляет запросы только на работоспособные экземпляры Amazon EC2, зарегистрированные в балансировщике. (Окружение автоматически содержит балансировщик ELB, если оно включает более одного экземпляра Amazon EC2.) Если вы установите EvaluateTargetHealth в значение true, и при этом ни один из экземпляров Amazon EC2 не работает или сам балансировщик не работает, Route 53 перенаправляет запросы на другие доступные и работоспособные ресурсы, если таковые имеются.

Если окружение содержит единственный экземпляр Amazon EC2, нет особых требований.

Балансировщики нагрузки ELB

Поведение проверки работоспособности зависит от типа балансировщика:

Классические балансировщики : Если вы указываете классический балансировщик ELB в DNSName, Elastic Load Balancing направляет запросы только на работоспособные экземпляры Amazon EC2, зарегистрированные в балансировщике. Если вы установите EvaluateTargetHealth в значение true, и при этом ни один EC2 экземпляр не работает или сам балансировщик не работает, Route 53 перенаправляет запросы на другие ресурсы.
Прикладные и сетевые балансировщики : Если вы указываете прикладной или сетевой балансировщик ELB и установите EvaluateTargetHealth в значение true, Route 53 направляет запросы к балансировщику, основываясь на работоспособности целевых групп, связанных с балансировщиком:
- Для того, чтобы прикладной или сетевой балансировщик считался работоспособным, каждая целевая группа, содержащая цели, должна содержать как минимум одну работоспособную цель. Если любая целевая группа содержит только неработоспособные цели, балансировщик считается неработоспособным, и Route 53 направляет запросы на другие ресурсы.
- Целевая группа без зарегистрированных целей считается неработоспособной.

Примечание

При создании балансировщика вы настраиваете параметры проверки работоспособности Elastic Load Balancing; они не являются проверками работоспособности Route 53, но выполняют аналогичную функцию. Не создавайте проверки работоспособности Route 53 для экземпляров EC2, которые вы регистрируете в балансировщике ELB.

Ведра S3

Нет особых требований к установке EvaluateTargetHealth в значение true, когда целевой alias — ведро S3.

Другие записи в той же зоне размещения

Если ресурс Amazon Web Services, который вы указываете в DNSName, является записью или группой записей (например, группой взвешенных записей), но не является другой записью alias, рекомендуется связать проверку работоспособности со всеми записями в целевом alias. Дополнительную информацию см. в разделе Что произойдет, если вы пропустите проверки работоспособности? в Руководстве разработчика Amazon Route 53.

Дополнительную информацию и примеры см. в разделах Проверки работоспособности Amazon Route 53 и резервирование DNS в Руководстве разработчика Amazon Route 53.

HealthCheckId -> (строка)

Если вы хотите, чтобы Amazon Route 53 возвращал эту ресурсную запись в ответ на запрос DNS только при статусе проверки работоспособности «работает», добавьте элемент HealthCheckId и укажите идентификатор соответствующей проверки работоспособности.

Route 53 определяет, является ли ресурсная запись работоспособной, на основании следующего:

Через периодические отправки запроса на указанный в проверке работоспособности конечный пункт
Через агрегацию статуса указанной группы проверок работоспособности (вычисляемые проверки работоспособности)
Через определение текущего состояния оповещения CloudWatch (проверки работоспособности метрик CloudWatch)

Предупреждение

Route 53 не проверяет работоспособность конечной точки, указанной в ресурсной записи, например, конечной точки, указанной IP-адресом в элементе Value. Когда вы добавляете элемент HealthCheckId в ресурсную запись, Route 53 проверяет работоспособность конечной точки, указанной вами в проверке работоспособности.

Дополнительную информацию см. в следующих разделах Руководства разработчика Amazon Route 53:

Как Amazon Route 53 определяет, является ли конечная точка работоспособной
Проверки работоспособности Route 53 и резервирование DNS
Настройка резервирования в частной зоне размещения

Когда указывать HealthCheckId

Указание значения для HealthCheckId полезно только тогда, когда Route 53 выбирает между двумя или более ресурсными записями для ответа на запрос DNS, и вы хотите, чтобы Route 53 частично основывал выбор на статусе проверки работоспособности. Настройка проверок работоспособности имеет смысл только в следующих конфигурациях:

Ресурсные записи без алиасов : Вы проверяете работоспособность группы ресурсных записей без алиасов, имеющих ту же политику маршрутизации, имя и тип (например, несколько взвешенных записей с именем www.example.com и типом A), и указываете идентификаторы проверок работоспособности для всех ресурсных записей. Если статус проверки работоспособности ресурсной записи — «работает», Route 53 включает запись в список записей, которые она возвращает в ответах на запросы DNS. Если статус проверки работоспособности ресурсной записи — «не работает», Route 53 прекращает отвечать на запросы DNS с использованием значения для этой ресурсной записи. Если статус проверки работоспособности всех ресурсных записей в группе — «не работает», Route 53 рассматривает все ресурсные записи в группе как работоспособные и отвечает на запросы DNS соответствующим образом.
Ресурсные записи alias : Вы указываете следующие параметры:
- Вы устанавливаете EvaluateTargetHealth в значение true для записи alias в группе ресурсных записей, имеющих ту же политику маршрутизации, имя и тип (например, несколько взвешенных записей с именем www.example.com и типом A).
- Вы настраиваете запись alias для маршрутизации трафика на ресурсную запись без алиаса в той же зоне размещения.
- Вы указываете идентификатор проверки работоспособности для записи без алиаса.

Если статус проверки работоспособности — «работает», Route 53 считает запись alias работоспособной и включает запись alias в список записей, которые она возвращает в ответах на запросы DNS.

Если статус проверки работоспособности — «не работает», Route 53 прекращает отвечать на запросы DNS с использованием записи alias.

Примечание

Запись alias также может маршрутизировать трафик на группу ресурсных записей без алиасов, имеющих ту же политику маршрутизации, имя и тип. В этой конфигурации свяжите проверки работоспособности со всеми ресурсными записями в группе ресурсных записей без алиасов.

Маршрутизация по местоположению

Для ресурсных записей по местоположению, если конечная точка не работает, Route 53 ищет ресурсную запись для более крупного связанного географического региона. Например, предположим, что у вас есть ресурсные записи для штата в США, для всей страны США, для Северной Америки и ресурсная запись, для которой * для CountryCode — *, что применимо ко всем местоположениям. Если конечная точка для ресурсной записи штата не работает, Route 53 проверяет работоспособные ресурсные записи в следующем порядке, пока не найдет ресурсную запись, для которой конечная точка работает:

США
Северная Америка
Ресурсная запись по умолчанию

Указание конечной точки проверки работоспособности по имени домена

Если ваши проверки работоспособности указывают конечную точку только по имени домена, рекомендуется создавать отдельную проверку работоспособности для каждой конечной точки. Например, создайте проверку работоспособности для каждого сервера HTTP, который предоставляет контент для www.example.com. Для значения FullyQualifiedDomainName укажите имя домена сервера (например, us-east-2-www.example.com), а не имя ресурсных записей (www.example.com).

Предупреждение

Результаты проверок работоспособности будут непредсказуемыми, если вы выполните следующие действия:

Создайте проверку работоспособности, которая имеет то же значение для FullyQualifiedDomainName, что и имя ресурсной записи.
Свяжите эту проверку работоспособности с ресурсной записью.

TrafficPolicyInstanceId -> (строка)

При создании экземпляра политики трафика Amazon Route 53 автоматически создаёт ресурсную запись. TrafficPolicyInstanceId — это идентификатор экземпляра политики трафика, для которого Route 53 создал эту ресурсную запись.

Предупреждение

Для удаления ресурсной записи, связанной с экземпляром политики трафика, используйте DeleteTrafficPolicyInstance. Route 53 удалит ресурсную запись автоматически. Если вы удалите ресурсную запись с помощью ChangeResourceRecordSets, Route 53 не удалит экземпляр политики трафика автоматически, и вы будете продолжать платить за него, даже если он больше не используется.

CidrRoutingConfig -> (структура)

Объект, указанный в объекте ресурсной записи, когда вы связываете ресурсную запись с расположением CIDR.

LocationName со звёздочкой «*» может быть использована для создания записи CIDR по умолчанию. CollectionId по-прежнему требуется для записи по умолчанию.

CollectionId -> (строка)

Идентификатор коллекции CIDR.

LocationName -> (строка)

Имя расположения коллекции CIDR.

GeoProximityLocation -> (структура)

Наборы записей ресурсов GeoproximityLocation только: Сложный тип, который позволяет контролировать, как Route 53 отвечает на запросы DNS в зависимости от географического происхождения запроса и ваших ресурсов.

AWSRegion -> (строка)

Регион Amazon Web Services, в котором находится ресурс, которому вы направляете трафик DNS.

LocalZoneGroup -> (строка)

Указывает группу локальных зон Amazon Web Services.

Группа локальных зон обычно представляет собой код локальной зоны без заключительного символа. Например, если локальная зона — us-east-1-bue-1a, то группа локальных зон — us-east-1-bue-1.

Вы можете определить группу локальных зон для конкретной локальной зоны, используя команду describe-availability-zones CLI:

Эта команда возвращает: "GroupName": "us-west-2-den-1", указывая, что локальная зона us-west-2-den-1a принадлежит группе локальных зон us-west-2-den-1.

Coordinates -> (структура)

Содержит долготу и широту географического региона.

Latitude -> (строка)

Указывает координату север-юг географической точки на поверхности Земли (-90 - 90).

Longitude -> (строка)

Указывает координату восток-запад географической точки на поверхности Земли (-180 - 180).

Bias -> (целое число)

Смещение увеличивает или уменьшает размер географического региона, из которого Route 53 направляет трафик на ресурс.

Чтобы использовать Bias для изменения размера географического региона, укажите соответствующее значение смещения:

Чтобы расширить размер географического региона, из которого Route 53 направляет трафик на ресурс, укажите положительное целое число от 1 до 99 для смещения. Route 53 уменьшает размер смежных регионов.
Чтобы уменьшить размер географического региона, из которого Route 53 направляет трафик на ресурс, укажите отрицательное смещение от -1 до -99. Route 53 увеличивает размер смежных регионов.

IsTruncated -> (булево)

Флаг, указывающий, остаются ли для перечисления другие наборы записей ресурсов. Если результаты были усечены, вы можете сделать запрос на получение страниц, используя элемент NextRecordName.

NextRecordName -> (строка)

Если результаты были усечены, имя следующей записи в списке.

Этот элемент присутствует только если IsTruncated равно true.

NextRecordType -> (строка)

Если результаты были усечены, тип следующей записи в списке.

Этот элемент присутствует только если IsTruncated равно true.

NextRecordIdentifier -> (строка)

Наборы записей ресурсов, которые имеют политику маршрутизации, отличную от простой: Если результаты были усечены для данного имени DNS и типа, значение SetIdentifier для следующего набора записей ресурсов с текущим именем DNS и типом.

Дополнительную информацию о политиках маршрутизации см. в разделе Выбор политики маршрутизации в руководстве разработчика Amazon Route 53.

MaxItems -> (строка)

Максимальное количество записей, которое вы запросили.