Spec-Zone.ru › AWS CLI v2

[ aws . route53domains ]

Проверка доступности домена

Описание

Эта операция проверяет доступность одного доменного имени. Обратите внимание, что если статус доступности домена «ожидание», необходимо отправить ещё один запрос, чтобы определить доступность доменного имени.

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

Синтаксис

  check-domain-availability
--domain-name <value>
[--idn-lang-code <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]

Параметры

--domain-name (строка)

Имя домена, для которого требуется проверить доступность. Домен верхнего уровня (TLD), такой как .com, должен быть поддерживаемым TLD сервисом Route 53. Список поддерживаемых TLD см. в разделе «Домены, которые можно зарегистрировать с помощью Amazon Route 53» в руководстве разработчика Amazon Route 53.

Доменное имя может содержать только следующие символы:

  • Буквы от a до z. Доменные имена не чувствительны к регистру.
  • Цифры от 0 до 9.
  • Дефис (-). Вы не можете указать дефис в начале или конце метки.
  • Точка (.) для разделения меток в имени, например, . в example.com.

Международные доменные имена не поддерживаются для некоторых доменных зон верхнего уровня. Чтобы определить, поддерживает ли используемый TLD международные доменные имена, см. раздел «Домены, которые можно зарегистрировать с помощью Amazon Route 53». Дополнительную информацию см. в разделе «Форматирование международных доменных имён».

--idn-lang-code (строка)

Зарезервировано для будущего использования.

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

Примеры

Примечание

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

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

Чтобы определить, можете ли вы зарегистрировать доменное имя с помощью Route 53

Следующая check-domain-availability команда возвращает информацию о том, доступно ли доменное имя example.com для регистрации с помощью Route 53.

Эта команда работает только в регионе us-east-1. Если ваш регион по умолчанию установлен в us-east-1, параметр region можно опустить.

aws route53domains check-domain-availability \
    --region us-east-1 \
    --domain-name example.com

Вывод:

{
    "Availability": "UNAVAILABLE"
}

Route 53 поддерживает большое количество доменных зон верхнего уровня (TLD), таких как .com и .jp, но мы не поддерживаем все доступные TLD. Если вы проверите доступность домена, и Route 53 не поддерживает TLD, check-domain-availability вернет следующее сообщение.

An error occurred (UnsupportedTLD) when calling the CheckDomainAvailability operation: <top-level domain> tld is not supported.

Список TLD, которые можно использовать при регистрации домена с помощью Route 53, см. в разделе «Домены, которые можно зарегистрировать с помощью Amazon Route 53» в руководстве разработчика Amazon Route 53. Более подробную информацию о регистрации домена с помощью Amazon Route 53 см. в разделе «Регистрация нового домена» в руководстве разработчика Amazon Route 53.

Вывод

Доступность -> (строка)

Доступно ли доменное имя для регистрации.

Примечание

Вы можете регистрировать только домены, обозначенные как AVAILABLE.

Допустимые значения:

ДОСТУПНО

Доменное имя доступно.

ЗАРЕЗЕРВИРОВАНО_В_РЕЗЕРВЕ

Доменное имя зарезервировано при определённых условиях.

ДОСТУПНО_ПРЕДЗАКАЗ

Доменное имя доступно и может быть предзаказано.

НЕИЗВЕСТНО

Регистр TLD не ответил с определённым ответом о том, доступно ли доменное имя. Route 53 может возвращать такой ответ по разным причинам, например, регистр выполняет техническое обслуживание. Попробуйте позже.

НЕВЕРНОЕ_ИМЯ_ДЛЯ_TLD

TLD недействителен. Например, он может содержать недопустимые символы.

ОЖИДАНИЕ

Регистр TLD не вернул ответ в ожидаемое время. Когда ответ задерживается, обычно это занимает всего несколько дополнительных секунд. Вы можете сразу же повторить запрос.

ЗАРЕЗЕРВИРОВАНО

Доменное имя зарезервировано для другого человека или организации.

НЕДОСТУПНО

Доменное имя недоступно.

НЕДОСТУПНО_ПОДПИСКА

Доменное имя недоступно.

НЕДОСТУПНО_ОГРАНИЧЕНО

Доменное имя запрещено.

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

Spec-Zone.ru

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