создание записи домена
Описание
Создаёт одну из следующих записей системы доменных имён (DNS) в зоне DNS домена: Address (A), каноническое имя (CNAME), почтовый обменник (MX), сервер имён (NS), начало зоны авторитета (SOA), локатор службы (SRV) или текст (TXT).
Операция create domain entry поддерживает управление доступом на основе тегов с помощью тегов ресурсов, применённых к ресурсу, идентифицированному по domain name . Дополнительную информацию можно найти в Руководстве разработчика Amazon Lightsail.
См. также: Документацию API AWS
Синтаксис
create-domain-entry
--domain-name <value>
--domain-entry <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 (строка)
example.com ), для которого вы хотите создать запись домена.--domain-entry (структура)
Массив пар ключ-значение, содержащих информацию о запросе записи домена.
id -> (строка)
name -> (строка)
target -> (строка)
Целевой IP-адрес (192.0.2.0 ) или сервер имён AWS (ns-111.awsdns-22.com. ).
Для балансировщиков нагрузки Lightsail значение выглядит как ab1234c56789c6b86aba6fb203d443bc-123456789.us-east-2.elb.amazonaws.com . Для распределений Lightsail значение выглядит как exampled1182ne.cloudfront.net . Для контейнерных служб Lightsail значение выглядит как container-service-1.example23scljs.us-west-2.cs.amazonlightsail.com . Не забудьте также установить isAlias на true при настройке записи A для балансировщика нагрузки, распределения или контейнерной службы Lightsail.
isAlias -> (булево)
true , указывает, является ли запись домена псевдонимом, используемым балансировщиком нагрузки Lightsail, контейнерной службой Lightsail, распределением сети доставки содержимого (CDN) Lightsail или другим ресурсом Amazon Web Services. Вы можете включить запись псевдонима (типа A) в свой запрос, которая указывает на имя DNS балансировщика нагрузки, контейнерной службы, распределения CDN или другого ресурса Amazon Web Services и направляет трафик на этот ресурс.type -> (строка)
Тип записи домена, например, адрес для IPv4 (A), адрес для IPv6 (AAAA), каноническое имя (CNAME), почтовый обменник (MX), сервер имён (NS), начало зоны авторитета (SOA), локатор службы (SRV) или текст (TXT).
Можно использовать следующие типы записей домена:
AAAAACNAMEMXNSSOASRVTXT
options -> (карта)
(Устаревшее) Параметры записи домена.
Примечание
В версиях до 29 ноября 2017 года этот параметр не включался в ответ API. Теперь он устарел.key -> (строка)
value -> (строка)
Сокращённый синтаксис:
id=string,name=string,target=string,isAlias=boolean,type=string,options={KeyName1=string,KeyName2=string}
Синтаксис JSON:
{
"id": "string",
"name": "string",
"target": "string",
"isAlias": true|false,
"type": "string",
"options": {"string": "string"
...}
}
--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-auto-prompt (булево)
Автоматически запрашивать параметры CLI.
--no-cli-auto-prompt (булево)
Отключить автоматическое запрошенние параметров CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию можно найти в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования в стиле Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Для создания записи домена (записи DNS)
Следующий create-domain-entry пример создаёт запись DNS (A) для вершины указанного домена, которая указывает на IP-адрес экземпляра.
Примечание: Операции API Lightsail, связанные с доменами, доступны только в регионе us-east-1. Если ваш профиль CLI настроен на использование другого региона, необходимо указать параметр --region us-east-1, иначе команда не выполнится.
aws lightsail create-domain-entry \
--region us-east-1 \
--domain-name example.com \
--domain-entry name=example.com,type=A,target=192.0.2.0
Вывод:
{
"operation": {
"id": "5be4494d-56f4-41fc-8730-693dcd0ef9e2",
"resourceName": "example.com",
"resourceType": "Domain",
"createdAt": 1569865296.519,
"location": {
"availabilityZone": "all",
"regionName": "global"
},
"isTerminal": true,
"operationType": "CreateDomainEntry",
"status": "Succeeded",
"statusChangedAt": 1569865296.519
}
}
Дополнительную информацию см. в разделах DNS в Amazon Lightsail и Создание зоны DNS для управления записями DNS вашего домена в Amazon Lightsail в Руководстве разработчика Lightsail.
Вывод
operation -> (структура)
Массив объектов, описывающих результат действия, такой как состояние запроса, метка времени запроса и ресурсы, затронутые запросом.
id -> (строка)
resourceName -> (строка)
resourceType -> (строка)
createdAt -> (метка времени)
1479816991.349 ).location -> (структура)
Регион и зона доступности Amazon Web Services.
availabilityZone -> (строка)
us-east-2a (регистрозависимый).regionName -> (строка)
isTerminal -> (булево)
operationDetails -> (строка)
Debian-1GB-Ohio-1 ).operationType -> (строка)
status -> (строка)
statusChangedAt -> (метка времени)
1479816991.349 ).errorCode -> (строка)
errorDetails -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.