Spec-Zone.ru › AWS CLI v2

[ aws . route53 ]

list-hosted-zones-by-vpc

Описание

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

  • Элемент OwningAccount, содержащий номер учетной записи текущей учетной записи Amazon Web Services или другой учетной записи Amazon Web Services. Некоторые службы, такие как Cloud Map, создают зоны размещения, используя текущую учетную запись.
  • Элемент OwningService, определяющий службу Amazon Web Services, которая создала и владеет зоной размещения. Например, если зона размещения была создана Amazon Elastic File System (Amazon EFS), значение Owner равно efs.amazonaws.com.
ListHostedZonesByVPC возвращает зоны размещения, связанные с указанным VPC, и не отражает ассоциации зон размещения с VPC через профили Route 53. Чтобы получить ассоциации с профилем, вызовите API ListProfileResourceAssociations.

Примечание

При перечислении частных зон размещения зона размещения и Amazon VPC должны принадлежать одной и той же секции, где были созданы зоны размещения. Секция — это группа регионов Amazon Web Services. Каждая учетная запись Amazon Web Services ограничена одной секцией.

Поддерживаемые секции:

  • aws - Регионы Amazon Web Services
  • aws-cn - Регионы Китая
  • aws-us-gov - Регион Amazon Web Services GovCloud (США)

Дополнительную информацию см. в разделе Управление доступом в Общие сведения об Amazon Web Services.

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

Синтаксис

  list-hosted-zones-by-vpc
--vpc-id <value>
--vpc-region <value>
[--max-items <value>]
[--next-token <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]

Параметры

--vpc-id (строка)

Идентификатор Amazon VPC, для которого вы хотите перечислить зоны размещения.

--vpc-region (строка)

Для Amazon VPC, который вы указали для VPCId, регион Amazon Web Services, в котором вы создали VPC.

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

  • us-east-1
  • us-east-2
  • us-west-1
  • us-west-2
  • eu-west-1
  • eu-west-2
  • eu-west-3
  • eu-central-1
  • eu-central-2
  • ap-east-1
  • me-south-1
  • us-gov-west-1
  • us-gov-east-1
  • us-iso-east-1
  • us-iso-west-1
  • us-isob-east-1
  • me-central-1
  • ap-southeast-1
  • ap-southeast-2
  • ap-southeast-3
  • ap-south-1
  • ap-south-2
  • ap-northeast-1
  • ap-northeast-2
  • ap-northeast-3
  • eu-north-1
  • sa-east-1
  • ca-central-1
  • cn-north-1
  • cn-northwest-1
  • af-south-1
  • eu-south-1
  • eu-south-2
  • ap-southeast-4
  • il-central-1
  • ca-west-1
  • ap-southeast-5
  • mx-central-1
  • us-isof-south-1
  • us-isof-east-1
  • ap-southeast-7

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

(Необязательно) Максимальное количество зон размещения, которое вы хотите вернуть Amazon Route 53. Если указанный VPC связан с более чем MaxItems зонами размещения, ответ включает элемент NextToken. NextToken содержит зашифрованный маркер, который идентифицирует первую зону размещения, которую Route 53 вернет, если вы отправите другой запрос.

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

Если предыдущий ответ включал элемент NextToken, указанный VPC связан с большим количеством зон размещения. Чтобы получить больше зон размещения, отправьте другой запрос ListHostedZonesByVPC.

Для значения NextToken укажите значение NextToken из предыдущего ответа.

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

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

Вывод

HostedZoneSummaries -> (список)

Список, содержащий по одному элементу HostedZoneSummary для каждой зоны размещения, с которой связан указанный Amazon VPC. Каждый элемент HostedZoneSummary содержит имя и идентификатор зоны размещения, а также информацию о владельце зоны размещения.

(структура)

В ответе на запрос ListHostedZonesByVPC элемент HostedZoneSummaries содержит по одному элементу HostedZoneSummary для каждой зоны размещения, с которой связан указанный Amazon VPC. Каждый элемент HostedZoneSummary содержит имя и идентификатор зоны размещения, а также информацию о владельце зоны размещения.

HostedZoneId -> (строка)

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

Name -> (строка)

Имя частной зоны размещения, например, example.com.

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

Владелец частной зоны размещения, с которой связан указанный VPC. Владелец может быть либо учетной записью Amazon Web Services, либо службой Amazon Web Services.

OwningAccount -> (строка)

Если зона размещения была создана учетной записью Amazon Web Services или была создана службой Amazon Web Services, которая создает зоны размещения, используя текущую учетную запись, OwningAccount содержит идентификатор учетной записи этой учетной записи. Например, при использовании Cloud Map для создания зоны размещения Cloud Map создает зону размещения, используя текущую учетную запись Amazon Web Services.

OwningService -> (строка)

Если служба Amazon Web Services использует свою собственную учетную запись для создания зоны размещения и связывает указанный VPC с этой зоной размещения, OwningService содержит аббревиатуру, которая идентифицирует службу. Например, если Amazon Elastic File System (Amazon EFS) создала зону размещения и связала VPC с этой зоной размещения, значение OwningService равно efs.amazonaws.com.

MaxItems -> (строка)

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

NextToken -> (строка)

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

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

Spec-Zone.ru

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