[ 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 не вернул ответ в ожидаемое время. Когда ответ задерживается, обычно это занимает всего несколько дополнительных секунд. Вы можете сразу же повторить запрос.
Доменное имя зарезервировано для другого человека или организации.
Доменное имя недоступно.
Доменное имя недоступно.
Доменное имя запрещено.
© Copyright 2025, Amazon Web Services. Created using Sphinx.