Spec-Zone.ru › AWS CLI v2

[ aws . route53 ]

list-traffic-policy-instances

Описание

Получает информацию о экземплярах политик трафика, созданных с использованием текущей учетной записи Amazon Web Services.

Примечание

После отправки запроса UpdateTrafficPolicyInstance, наблюдается небольшая задержка, пока Amazon Route 53 создает записи ресурса, указанные в определении политики трафика. Дополнительную информацию см. в элементе ответа State.

Route 53 возвращает максимум 100 элементов в каждом ответе. Если у вас много экземпляров политик трафика, вы можете использовать параметр MaxItems, чтобы перечислять их группами по 100.

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

Синтаксис

  list-traffic-policy-instances
[--hosted-zone-id-marker <value>]
[--traffic-policy-instance-name-marker <value>]
[--traffic-policy-instance-type-marker <value>]
[--max-items <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-marker (строка)

Если значение IsTruncated в предыдущем ответе было true, у вас есть дополнительные экземпляры политик трафика. Чтобы получить дополнительные экземпляры политик трафика, отправьте другой запрос ListTrafficPolicyInstances. Для значения HostedZoneId укажите значение HostedZoneIdMarker из предыдущего ответа, которое является идентификатором размещенной зоны первого экземпляра политики трафика в следующей группе экземпляров политик трафика.

Если значение IsTruncated в предыдущем ответе было false, больше экземпляров политик трафика нет.

--traffic-policy-instance-name-marker (строка)

Если значение IsTruncated в предыдущем ответе было true, у вас есть дополнительные экземпляры политик трафика. Чтобы получить дополнительные экземпляры политик трафика, отправьте другой запрос ListTrafficPolicyInstances. Для значения trafficpolicyinstancename укажите значение TrafficPolicyInstanceNameMarker из предыдущего ответа, которое является именем первого экземпляра политики трафика в следующей группе экземпляров политик трафика.

Если значение IsTruncated в предыдущем ответе было false, больше экземпляров политик трафика нет.

--traffic-policy-instance-type-marker (строка)

Если значение IsTruncated в предыдущем ответе было true, у вас есть дополнительные экземпляры политик трафика. Чтобы получить дополнительные экземпляры политик трафика, отправьте другой запрос ListTrafficPolicyInstances. Для значения trafficpolicyinstancetype укажите значение TrafficPolicyInstanceTypeMarker из предыдущего ответа, которое является типом первого экземпляра политики трафика в следующей группе экземпляров политик трафика.

Если значение IsTruncated в предыдущем ответе было false, больше экземпляров политик трафика нет.

Возможные значения:

  • SOA
  • A
  • TXT
  • NS
  • CNAME
  • MX
  • NAPTR
  • PTR
  • SRV
  • SPF
  • AAAA
  • CAA
  • DS
  • TLSA
  • SSHFP
  • SVCB
  • HTTPS

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

Максимальное количество экземпляров политик трафика, которое вы хотите, чтобы Amazon Route 53 вернул в ответ на запрос ListTrafficPolicyInstances. Если у вас больше чем MaxItems экземпляров политик трафика, значение элемента IsTruncated в ответе равно true, а значения HostedZoneIdMarker, TrafficPolicyInstanceNameMarker и TrafficPolicyInstanceTypeMarker представляют первый экземпляр политики трафика в следующей группе из MaxItems экземпляров политик трафика.

--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
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

Регион для использования. Переопределяет настройки config/env.

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

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

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

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

Сборник сертификатов CA для использования при проверке сертификатов SSL. Переопределяет настройки config/env.

--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.

Вывод

TrafficPolicyInstances -> (список)

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

(структура)

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

Id -> (строка)

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

HostedZoneId -> (строка)

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

Name -> (строка)

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

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

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

State -> (строка)

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

Applied

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

Creating

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

Failed

Route 53 не смог создать или обновить наборы записей ресурсов. Если значение State равно Failed, см. Message для объяснения причины неудачи запроса.

Message -> (строка)

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

TrafficPolicyId -> (строка)

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

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

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

TrafficPolicyType -> (строка)

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

HostedZoneIdMarker -> (строка)

Если IsTruncated равно true, HostedZoneIdMarker — это идентификатор размещенной зоны первого экземпляра политики трафика, который Route 53 вернёт, если вы отправите ещё один запрос ListTrafficPolicyInstances.

TrafficPolicyInstanceNameMarker -> (строка)

Если IsTruncated равно true, TrafficPolicyInstanceNameMarker — это имя первого экземпляра политики трафика, который Route 53 вернёт, если вы отправите ещё один запрос ListTrafficPolicyInstances.

TrafficPolicyInstanceTypeMarker -> (строка)

Если IsTruncated равно true, TrafficPolicyInstanceTypeMarker — это тип DNS наборов записей ресурсов, связанных с первым экземпляром политики трафика, который Amazon Route 53 вернёт, если вы отправите ещё один запрос ListTrafficPolicyInstances.

IsTruncated -> (булево)

Флаг, указывающий, есть ли ещё экземпляры политики трафика для перечисления. Если ответ был урезан, вы можете получить больше экземпляров политики трафика, снова вызвав ListTrafficPolicyInstances и указав значения HostedZoneIdMarker, TrafficPolicyInstanceNameMarker и TrafficPolicyInstanceTypeMarker в соответствующих параметрах запроса.

MaxItems -> (строка)

Значение, указанное вами для параметра MaxItems в вызове ListTrafficPolicyInstances, который породил текущий ответ.

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

Spec-Zone.ru

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