Spec-Zone.ru › AWS CLI v2

[ aws . route53 ]

обновить-политику-трафика-экземпляр

Описание

Примечание

После отправки запроса UpdateTrafficPolicyInstance, происходит небольшая задержка, пока Route 53 создаёт записи ресурсов, указанные в определении политики трафика. Используйте GetTrafficPolicyInstance с id обновлённого экземпляра политики трафика, чтобы подтвердить, что запрос UpdateTrafficPolicyInstance был успешно выполнен. Дополнительную информацию см. в элементе ответа State.

Обновляет записи ресурсов в указанной зоне размещения, которые были созданы на основе настроек в указанной версии политики трафика.

При обновлении экземпляра политики трафика Amazon Route 53 продолжает отвечать на запросы DNS для имени корневой записи ресурса (например, example.com), в то время как он заменяет одну группу записей ресурса другой. Route 53 выполняет следующие операции:

  • Route 53 создаёт новую группу записей ресурсов на основе указанной политики трафика. Это верно независимо от того, насколько существенны различия между существующими записями ресурсов и новыми записями ресурсов.
  • После создания всех новых записей ресурсов Route 53 начинает отвечать на запросы DNS для имени корневой записи ресурса (например, example.com) с помощью новых записей ресурсов.
  • Route 53 удаляет старую группу записей ресурсов, связанных с именем корневой записи ресурса.

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

Синтаксис

  update-traffic-policy-instance
--id <value>
--ttl <value>
--traffic-policy-id <value>
--traffic-policy-version <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]

Параметры

--id (строка)

Идентификатор экземпляра политики трафика, который вы хотите обновить.

--ttl (целое число)

TTL, который вы хотите, чтобы Amazon Route 53 назначил всем обновлённым записям ресурсов.

--traffic-policy-id (строка)

Идентификатор политики трафика, который вы хотите, чтобы Amazon Route 53 использовал для обновления записей ресурсов для указанного экземпляра политики трафика.

--traffic-policy-version (целое число)

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

--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 (строка)

Набор сертификатов 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 для вывода.

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

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

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

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

Вывод

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

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

Id -> (строка)

Идентификатор, назначенный Amazon Route 53 новому экземпляру политики трафика.

HostedZoneId -> (строка)

Идентификатор зоны размещения, в которой Amazon Route 53 создал записи ресурсов.

Name -> (строка)

Имя DNS, например www.example.com, для которого Amazon Route 53 отвечает на запросы с использованием записей ресурсов, связанных с этим экземпляром политики трафика.

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

TTL, назначенный Amazon Route 53 всем записям ресурсов, которые он создал в указанной зоне размещения.

State -> (строка)

Значение State может принимать одно из следующих значений:

Применено

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

Создание

Route 53 создаёт записи ресурсов. Используйте GetTrafficPolicyInstance, чтобы подтвердить, что запрос CreateTrafficPolicyInstance был успешно выполнен.

Ошибка

Route 53 не смог создать или обновить записи ресурсов. Когда значение State равно Failed, см. Message, чтобы узнать, что привело к ошибке запроса.

Message -> (строка)

Если State имеет значение Failed, это объяснение причины ошибки. Если State имеет другое значение, Message пустое.

TrafficPolicyId -> (строка)

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

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

Версия политики трафика, которую Amazon Route 53 использовал для создания записей ресурсов в указанной зоне размещения.

TrafficPolicyType -> (строка)

Тип DNS, назначенный Amazon Route 53 всем записям ресурсов, которые он создал для этого экземпляра политики трафика.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API