create-hosted-zone

Описание

Создает новую публичную или частную зону размещения. Вы создаете записи в публичной зоне размещения, чтобы определить, как вы хотите маршрутизировать трафик в интернете для домена, такого как example.com, и его поддоменов (apex.example.com, acme.example.com). Вы создаете записи в частной зоне размещения, чтобы определить, как вы хотите маршрутизировать трафик для домена и его поддоменов внутри одной или нескольких Amazon Virtual Private Clouds (Amazon VPC).

Дополнительную информацию о стоимости зон размещения см. в разделе Цены на Amazon Route 53.

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

• Вы не можете создать зону размещения для домена верхнего уровня (TLD), такого как .com.
• Для публичных зон размещения Route 53 автоматически создает запись SOA по умолчанию и четыре записи NS для зоны. Дополнительную информацию о записях SOA и NS см. в разделе NS и SOA-записи, создаваемые Route 53 для зоны размещения в Руководстве разработчика Amazon Route 53. Если вы хотите использовать те же имена серверов для нескольких публичных зон размещения, вы можете при необходимости связать с зоной размещения набор делегирования повторного использования. См. элемент DelegationSetId.
• Если ваш домен зарегистрирован у регистратора, отличного от Route 53, вы должны обновить имена серверов у своего регистратора, чтобы сделать Route 53 службой DNS для домена. Дополнительную информацию см. в разделе Миграция службы DNS для существующего домена в Amazon Route 53 в Руководстве разработчика Amazon Route 53.

При отправке запроса CreateHostedZone начальный статус зоны размещения составляет PENDING. Для публичных зон размещения это означает, что записи NS и SOA пока не доступны на всех серверах DNS Route 53. Когда записи NS и SOA будут доступны, статус зоны изменится на INSYNC.

Для запроса CreateHostedZone у вызывающего абонента должны быть разрешения ec2:DescribeVpcs.

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

Синтаксис

  create-hosted-zone
--name <value>
[--vpc <value>]
--caller-reference <value>
[--hosted-zone-config <value>]
[--delegation-set-id <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]

Параметры

--name (строка)

--vpc (структура)

Краткая синтаксическая конструкция:

VPCRegion=string,VPCId=string

Синтаксис JSON:

{
  "VPCRegion": "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",
  "VPCId": "string"
}

--caller-reference (строка)

--hosted-zone-config (структура)

Не включайте PrivateZone в эту структуру ввода. Его значение возвращается в выводе команды.

Краткая синтаксическая конструкция:

Comment=string,PrivateZone=boolean

Синтаксис JSON:

{
  "Comment": "string",
  "PrivateZone": true|false
}

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

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

Примеры

Для создания зоны размещения

Следующая create-hosted-zone команда добавляет зону размещения с именем example.com, используя ссылку на вызывающего 2014-04-01-18:47. Дополнительный комментарий содержит пробел, поэтому он должен быть заключен в кавычки:

aws route53 create-hosted-zone --name example.com --caller-reference 2014-04-01-18:47 --hosted-zone-config Comment="command-line version"

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

Вывод

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

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

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

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

Location -> (строка)