change-resource-record-sets

Описание

Создаёт, изменяет или удаляет набор записей ресурсов, содержащий авторитетные данные DNS для указанного доменного имени или поддоменного имени. Например, вы можете использовать ChangeResourceRecordSets для создания набора записей ресурсов, который перенаправляет трафик для test.example.com на веб-сервер с IP-адресом 192.0.2.44.

Удаление наборов записей ресурсов

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

Пакеты изменений и транзакционные изменения

Тело запроса должно содержать документ с элементом ChangeResourceRecordSetsRequest. Тело запроса содержит список элементов изменений, известный как пакет изменений. Пакеты изменений рассматриваются как транзакционные изменения. Route 53 проверяет изменения в запросе и затем либо выполняет все изменения в пакете запроса изменений, либо не выполняет ни одного. Это гарантирует, что перенаправление DNS не пострадает от частичных изменений наборов записей ресурсов в зоне размещения.

Например, предположим, что пакет запроса изменений содержит два изменения: он удаляет набор записей ресурсов CNAME для www.example.com и создаёт набор записей ресурсов алиаса для www.example.com. Если проверка для обеих записей пройдёт успешно, Route 53 удалит первый набор записей ресурсов и создаст второй набор записей ресурсов в одной операции. Если проверка для действия DELETE или CREATE завершится неудачно, запрос будет отменён, и исходная запись CNAME продолжит существовать.

Примечание

Если вы пытаетесь удалить один и тот же набор записей ресурсов более одного раза в одном пакете изменений, Route 53 вернёт ошибку InvalidChangeBatch.

Поток трафика

Для создания наборов записей ресурсов для сложных конфигураций перенаправления используйте визуальный редактор потока трафика в консоли Route 53 или API-действия для политик трафика и экземпляров политик трафика. Сохраните конфигурацию как политику трафика, а затем ассоциируйте политику трафика с одним или несколькими доменными именами (например, example.com) или поддоменными именами (например, www.example.com) в той же зоне размещения или в нескольких зонах размещения. Вы можете отменить обновления, если новая конфигурация не работает должным образом. Дополнительную информацию см. в разделе Использование потока трафика для перенаправления трафика DNS в Руководстве разработчика Amazon Route 53.

Создать, удалить и обновить

Используйте ChangeResourceRecordsSetsRequest для выполнения следующих действий:

CREATE : Создаёт набор записей ресурсов, имеющий указанные значения.
DELETE : Удаляет существующий набор записей ресурсов, имеющий указанные значения.
UPSERT : Если набор ресурсов не существует, Route 53 создаёт его. Если набор ресурсов существует, Route 53 обновляет его значениями из запроса.

Синтаксисы для создания, обновления и удаления наборов записей ресурсов

Синтаксис запроса зависит от типа набора записей ресурсов, который вы хотите создать, удалить или обновить, например, взвешенного, алиаса или резервирования. Элементы XML в вашем запросе должны появляться в указанном порядке.

Пример для каждого типа набора записей ресурсов см. в разделе «Примеры».

Не ссылайтесь на синтаксис в разделе «Синтаксис параметров», который включает все элементы для каждого типа набора записей ресурсов, который можно создать, удалить или обновить с помощью ChangeResourceRecordSets.

Распространение изменений в серверах DNS Route 53

Когда вы отправляете запрос ChangeResourceRecordSets, Route 53 распространяет ваши изменения на все авторитетные сервера DNS Route 53, управляющие зоной размещения. Пока ваши изменения распространяются, GetChange возвращает статус PENDING. После завершения распространения GetChange возвращает статус INSYNC. Изменения обычно распространяются на все серверы имен Route 53, управляющие зоной размещения, в течение 60 секунд. Дополнительную информацию см. в GetChange.

Ограничения на запросы ChangeResourceRecordSets

Дополнительную информацию об ограничениях запроса ChangeResourceRecordSets см. в разделе «Ограничения» в Руководстве разработчика Amazon Route 53.

См. также: Документацию API AWS

Резюме

  change-resource-record-sets
--hosted-zone-id <value>
--change-batch <value>
[--cli-input-json | --cli-input-yaml]
[--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 (строка)

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

--change-batch (структура)

Сложный тип, содержащий необязательный комментарий и элемент Changes.

Комментарий -> (строка)

Необязательно: Любые комментарии, которые вы хотите включить в запрос изменения партии.

Изменения -> (список)

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

(структура)

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

Действие -> (строка)

Действие, которое необходимо выполнить:

CREATE : Создает запись ресурса с указанными значениями.
DELETE : Удаляет существующую запись ресурса.

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

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

UPSERT : Если запись ресурса еще не существует, Route 53 создает её. Если запись ресурса существует, Route 53 обновит её значениями из запроса.

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

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

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

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

Только ChangeResourceRecordSets

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

Для получения информации о том, как указывать символы, отличные от a-z , 0-9 и - (тире) и как указывать интернационализированные доменные имена, см. Формат доменных имён DNS в руководстве разработчика 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 активного-активного и активного-пассивного резервирования в руководстве разработчика 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 использует двухбуквенные коды стран, указанные в международном стандарте 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 alias необходимо также включить элемент EvaluateTargetHealth и установить значение true.

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

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

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

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

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

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

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

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

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

ResourceRecords -> (список)

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

Примечание

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

(структура)

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

Примечание

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

Value -> (строка)

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

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

Примечание

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

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

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

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

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

HostedZoneId -> (строка)

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

Пользовательские региональные 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 .

Примечание

Записи ресурса alias для 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 в вашей зоне размещения

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

DNSName -> (строка)

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

Пользовательские региональные 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.

Примечание

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

Среда Elastic Beanstalk

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

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

Для сред, созданных до начала 2016 года, доменное имя не включает регион. Чтобы направить трафик на эти среды, необходимо создать запись CNAME вместо записи alias. Обратите внимание, что запись 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. Дополнительную информацию см. в справке API Elastic Beanstalk DescribeEnvironments.
CLI: Используйте команду describe-environments для получения значения атрибута CNAME. Дополнительную информацию см. в справке по командам CLI describe-environments.

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

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

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

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

API Global Accelerator: Для получения DNS-имени используйте DescribeAccelerator.
CLI: Для получения DNS-имени используйте 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 для записи ресурса в текущей зоне размещения.

Примечание

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

EvaluateTargetHealth -> (булево)

Применяется только к наборам записей ресурсов алиасов, алиасов резервного копирования, геолокационных алиасов, алиасов задержки и взвешенных алиасов: Когда EvaluateTargetHealth имеет значение true, набор записей ресурсов алиаса наследует состояние работоспособности связанного ресурса Amazon Web Services, например, балансировщика нагрузки ELB или другого набора записей ресурсов в зоне размещения.

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

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

Нельзя установить EvaluateTargetHealth в значение true, когда целевым алиасом является дистрибутив CloudFront.

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

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

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

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

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

Классические балансировщики : Если в DNSName указан классический балансировщик ELB, 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, когда целевой алиас — ведро S3, специальных требований нет.

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

Если ресурс Amazon Web Services, указанный в DNSName, представляет собой запись или группу записей (например, группу взвешенных записей), но не является другой записью алиаса, рекомендуется ассоциировать проверку работоспособности со всеми записями в целевом алиасе. Дополнительную информацию см. в разделе «Что происходит, когда вы опускаете проверки работоспособности?» в руководстве разработчика 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 соответствующим образом.
Наборы записей ресурсов алиасов : Вы устанавливаете следующие параметры:
- Вы устанавливаете EvaluateTargetHealth в значение true для набора записей ресурсов алиаса в группе наборов записей ресурсов, которые имеют ту же политику маршрутизации, имя и тип (например, несколько взвешенных записей с именем www.example.com типа A).
- Вы настраиваете набор записей ресурсов алиаса для маршрутизации трафика на набор записей ресурсов без алиасов в той же зоне размещения.
- Вы указываете идентификатор проверки работоспособности для набора записей ресурсов без алиасов.

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

Если состояние проверки работоспособности является неработоспособным, Route 53 прекращает ответы на запросы DNS, используя набор записей ресурсов алиаса.

Примечание

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

Геолокационная маршрутизация

Для наборов записей ресурсов геолокации, если конечная точка неработоспособна, 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 -> (string)

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

LocalZoneGroup -> (string)

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

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

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

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

Coordinates -> (structure)

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

Latitude -> (string)

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

Longitude -> (string)

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

Bias -> (integer)

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

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

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

Синтаксис JSON:

{
  "Comment": "string",
  "Changes": [
    {
      "Action": "CREATE"|"DELETE"|"UPSERT",
      "ResourceRecordSet": {
        "Name": "string",
        "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"NAPTR"|"PTR"|"SRV"|"SPF"|"AAAA"|"CAA"|"DS"|"TLSA"|"SSHFP"|"SVCB"|"HTTPS",
        "SetIdentifier": "string",
        "Weight": long,
        "Region": "us-east-1"|"us-east-2"|"us-west-1"|"us-west-2"|"ca-central-1"|"eu-west-1"|"eu-west-2"|"eu-west-3"|"eu-central-1"|"eu-central-2"|"ap-southeast-1"|"ap-southeast-2"|"ap-southeast-3"|"ap-northeast-1"|"ap-northeast-2"|"ap-northeast-3"|"eu-north-1"|"sa-east-1"|"cn-north-1"|"cn-northwest-1"|"ap-east-1"|"me-south-1"|"me-central-1"|"ap-south-1"|"ap-south-2"|"af-south-1"|"eu-south-1"|"eu-south-2"|"ap-southeast-4"|"il-central-1"|"ca-west-1"|"ap-southeast-5"|"mx-central-1"|"ap-southeast-7"|"us-gov-east-1"|"us-gov-west-1",
        "GeoLocation": {
          "ContinentCode": "string",
          "CountryCode": "string",
          "SubdivisionCode": "string"
        },
        "Failover": "PRIMARY"|"SECONDARY",
        "MultiValueAnswer": true|false,
        "TTL": long,
        "ResourceRecords": [
          {
            "Value": "string"
          }
          ...
        ],
        "AliasTarget": {
          "HostedZoneId": "string",
          "DNSName": "string",
          "EvaluateTargetHealth": true|false
        },
        "HealthCheckId": "string",
        "TrafficPolicyInstanceId": "string",
        "CidrRoutingConfig": {
          "CollectionId": "string",
          "LocationName": "string"
        },
        "GeoProximityLocation": {
          "AWSRegion": "string",
          "LocalZoneGroup": "string",
          "Coordinates": {
            "Latitude": "string",
            "Longitude": "string"
          },
          "Bias": integer
        }
      }
    }
    ...
  ]
}

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

--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
текст
таблица
yaml
yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

включено
выключено
автоматически

--no-sign-request (логическое значение)

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

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

Файл с корневым сертификатом для проверки 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.

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

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

Если не указано иное, все примеры используют правила цитирования, характерные для Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. См. раздел "Использование кавычек со строками" в руководстве пользователя AWS CLI.

Для создания, обновления или удаления набора записей ресурсов

Следующая change-resource-record-sets команда создает набор записей ресурсов с использованием hosted-zone-id Z1R8UBAEXAMPLE и конфигурации в формате JSON из файла C:\awscli\route53\change-resource-record-sets.json:

aws route53 change-resource-record-sets --hosted-zone-id Z1R8UBAEXAMPLE --change-batch file://C:\awscli\route53\change-resource-record-sets.json

Дополнительную информацию см. в разделе POST ChangeResourceRecordSets в справочнике API Amazon Route 53.

Конфигурация в файле JSON зависит от типа набора записей ресурсов, который вы хотите создать:

Базовый
Взвешенный
Псевдоним
Взвешенный псевдоним
Задержка
Задержка псевдонима
Группирование по отказу
Группирование по отказу псевдонима

Базовый синтаксис:

{
  "Comment": "optional comment about the changes in this change batch request",
  "Changes": [
    {
      "Action": "CREATE"|"DELETE"|"UPSERT",
      "ResourceRecordSet": {
        "Name": "DNS domain name",
        "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
        "TTL": time to live in seconds,
        "ResourceRecords": [
          {
            "Value": "applicable value for the record type"
          },
          {...}
        ]
      }
    },
    {...}
  ]
}

Взвешенный синтаксис:

{
  "Comment": "optional comment about the changes in this change batch request",
  "Changes": [
    {
      "Action": "CREATE"|"DELETE"|"UPSERT",
      "ResourceRecordSet": {
        "Name": "DNS domain name",
        "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
        "SetIdentifier": "unique description for this resource record set",
        "Weight": value between 0 and 255,
        "TTL": time to live in seconds,
        "ResourceRecords": [
          {
            "Value": "applicable value for the record type"
          },
          {...}
        ],
        "HealthCheckId": "optional ID of an Amazon Route 53 health check"
      }
    },
    {...}
  ]
}

Синтаксис псевдонима:

{
  "Comment": "optional comment about the changes in this change batch request",
  "Changes": [
    {
      "Action": "CREATE"|"DELETE"|"UPSERT",
      "ResourceRecordSet": {
        "Name": "DNS domain name",
        "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
        "AliasTarget": {
          "HostedZoneId": "hosted zone ID for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or Amazon Route 53 hosted zone",
          "DNSName": "DNS domain name for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or another resource record set in this hosted zone",
          "EvaluateTargetHealth": true|false
        },
        "HealthCheckId": "optional ID of an Amazon Route 53 health check"
      }
    },
    {...}
  ]
}

Взвешенный синтаксис псевдонима:

{
  "Comment": "optional comment about the changes in this change batch request",
  "Changes": [
    {
      "Action": "CREATE"|"DELETE"|"UPSERT",
      "ResourceRecordSet": {
        "Name": "DNS domain name",
        "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
        "SetIdentifier": "unique description for this resource record set",
        "Weight": value between 0 and 255,
        "AliasTarget": {
          "HostedZoneId": "hosted zone ID for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or Amazon Route 53 hosted zone",
          "DNSName": "DNS domain name for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or another resource record set in this hosted zone",
          "EvaluateTargetHealth": true|false
        },
        "HealthCheckId": "optional ID of an Amazon Route 53 health check"
      }
    },
    {...}
  ]
}

Синтаксис задержки:

{
  "Comment": "optional comment about the changes in this change batch request",
  "Changes": [
    {
      "Action": "CREATE"|"DELETE"|"UPSERT",
      "ResourceRecordSet": {
        "Name": "DNS domain name",
        "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
        "SetIdentifier": "unique description for this resource record set",
        "Region": "Amazon EC2 region name",
        "TTL": time to live in seconds,
        "ResourceRecords": [
          {
            "Value": "applicable value for the record type"
          },
          {...}
        ],
        "HealthCheckId": "optional ID of an Amazon Route 53 health check"
      }
    },
    {...}
  ]
}

Синтаксис задержки псевдонима:

{
  "Comment": "optional comment about the changes in this change batch request",
  "Changes": [
    {
      "Action": "CREATE"|"DELETE"|"UPSERT",
      "ResourceRecordSet": {
        "Name": "DNS domain name",
        "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
        "SetIdentifier": "unique description for this resource record set",
        "Region": "Amazon EC2 region name",
        "AliasTarget": {
          "HostedZoneId": "hosted zone ID for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or Amazon Route 53 hosted zone",
          "DNSName": "DNS domain name for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or another resource record set in this hosted zone",
          "EvaluateTargetHealth": true|false
        },
        "HealthCheckId": "optional ID of an Amazon Route 53 health check"
      }
    },
    {...}
  ]
}

Синтаксис группирования по отказу:

{
  "Comment": "optional comment about the changes in this change batch request",
  "Changes": [
    {
      "Action": "CREATE"|"DELETE"|"UPSERT",
      "ResourceRecordSet": {
        "Name": "DNS domain name",
        "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
        "SetIdentifier": "unique description for this resource record set",
        "Failover": "PRIMARY" | "SECONDARY",
        "TTL": time to live in seconds,
        "ResourceRecords": [
          {
            "Value": "applicable value for the record type"
          },
          {...}
        ],
        "HealthCheckId": "ID of an Amazon Route 53 health check"
      }
    },
    {...}
  ]
}

Синтаксис группирования по отказу псевдонима:

{
  "Comment": "optional comment about the changes in this change batch request",
  "Changes": [
    {
      "Action": "CREATE"|"DELETE"|"UPSERT",
      "ResourceRecordSet": {
        "Name": "DNS domain name",
        "Type": "SOA"|"A"|"TXT"|"NS"|"CNAME"|"MX"|"PTR"|"SRV"|"SPF"|"AAAA",
        "SetIdentifier": "unique description for this resource record set",
        "Failover": "PRIMARY" | "SECONDARY",
        "AliasTarget": {
          "HostedZoneId": "hosted zone ID for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or Amazon Route 53 hosted zone",
          "DNSName": "DNS domain name for your CloudFront distribution, Amazon S3 bucket, Elastic Load Balancing load balancer, or another resource record set in this hosted zone",
          "EvaluateTargetHealth": true|false
        },
        "HealthCheckId": "optional ID of an Amazon Route 53 health check"
      }
    },
    {...}
  ]
}

Вывод

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

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

Этот элемент содержит идентификатор, который используется при выполнении действия GetChange для получения подробной информации об изменении.

Id -> (строка)

Status -> (строка)

Текущее состояние запроса. PENDING указывает, что этот запрос еще не был применен ко всем серверам DNS Amazon Route 53.

SubmittedAt -> (метка времени)

Дата и время отправки запроса об изменении в формате ISO 8601 и по координированному всемирному времени (UTC). Например, значение 2017-03-27T17:48:16.751Z соответствует 27 марта 2017 г. в 17:48:16.751 по UTC.

Comment -> (строка)

Комментарий, который вы можете предоставить.