Spec-Zone.ru › AWS CLI v2

[ aws . route53 ]

list-hosted-zones

Описание

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

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

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

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

Синтаксис

  list-hosted-zones
[--max-items <value>]
[--delegation-set-id <value>]
[--hosted-zone-type <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]

Параметры

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

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

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

--delegation-set-id (строка)

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

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

(Необязательно) Указывает, является ли зона размещения частной.

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

  • PrivateHostedZone

--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
  • текст
  • таблица
  • 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.

Примеры

Примечание

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

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

Для перечисления зон размещения, связанных с текущей учетной записью AWS

Следующая команда list-hosted-zones выводит сводную информацию о первых 100 зонах размещения, связанных с текущей учетной записью AWS:

aws route53 list-hosted-zones

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

aws route53 list-hosted-zones --max-items 1

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

aws route53 list-hosted-zones --max-items 1 --starting-token Z3M3LMPEXAMPLE

Вывод

HostedZones -> (список)

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

(структура)

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

Id -> (строка)

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

Name -> (строка)

Имя домена. Для публичных зон это имя, зарегистрированное у вашего регистратора DNS.

Для информации о том, как указать символы, отличные от a-z , 0-9 и - (тире), и о том, как указать домены с национальными символами, см. CreateHostedZone .

CallerReference -> (строка)

Значение, указанное вами при создании зоны.

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

Сложный тип, содержащий элементы Comment и PrivateZone. Если вы опустили элементы HostedZoneConfig и Comment в запросе, элементы Config и Comment не появятся в ответе.

Comment -> (строка)

Любые комментарии, которые вы хотите добавить к зоне.

PrivateZone -> (булево)

Указывает, является ли эта зона приватной.

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

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

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

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

ServicePrincipal -> (строка)

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

Description -> (строка)

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

Marker -> (строка)

Для второго и последующих вызовов ListHostedZones , Marker — это значение, указанное вами для параметра marker в запросе, который породил текущий ответ.

IsTruncated -> (булево)

Флаг, указывающий, есть ли еще зоны для перечисления. Если ответ был усечён, вы можете получить больше зон, отправив ещё один запрос ListHostedZones и указав значение NextMarker в параметре marker.

NextMarker -> (строка)

Если IsTruncated равно true , значение NextMarker идентифицирует первую зону в следующей группе зон. Отправьте другой запрос ListHostedZones и укажите значение NextMarker из ответа в параметре marker.

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

MaxItems -> (строка)

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

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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