get-domains
Описание
Возвращает список всех доменов в учетной записи пользователя.
См. также: Документацию API AWS
get-domains является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничностью, аргумент --query должен извлекать данные из результатов следующих выражений запроса: domains
Синтаксис
get-domains
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--max-items <value>]
[--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]
Параметры
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, предоставляемому --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределяют значения, предоставленные в JSON. Невозможно передать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет интерпретироваться буквально. Это нельзя указывать вместе с --cli-input-yaml.
--starting-token (строка)
Токен для указания места начала постраничной обработки. Это NextToken из ранее усеченного ответа.
Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя по AWS Command Line Interface.
--max-items (целое число)
Общее количество элементов, которые нужно вернуть в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Для возобновления постраничной обработки укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.
Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя по AWS Command Line Interface.
--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.
Для получения информации обо всех доменах
Следующий get-domains пример отображает сведения обо всех доменах в настроенном регионе AWS.
Примечание: Операции API Lightsail, связанные с доменами, доступны только в регионе us-east-1 AWS. Если ваш профиль CLI настроен на использование другого региона, необходимо указать параметр --region us-east-1, иначе команда завершится ошибкой.
aws lightsail get-domains \
--region us-east-1
Вывод:
{
"domains": [
{
"name": "example.com",
"arn": "arn:aws:lightsail:global:111122223333:Domain/28cda903-3f15-44b2-9baf-3EXAMPLEb304",
"supportCode": "6EXAMPLE3362//hostedzone/ZEXAMPLEONGSC1",
"createdAt": 1570728588.6,
"location": {
"availabilityZone": "all",
"regionName": "global"
},
"resourceType": "Domain",
"tags": [],
"domainEntries": [
{
"id": "-1682899164",
"name": "example.com",
"target": "192.0.2.0",
"isAlias": false,
"type": "A"
},
{
"id": "1703104243",
"name": "example.com",
"target": "ns-137.awsdns-17.com",
"isAlias": false,
"type": "NS"
},
{
"id": "-1038331153",
"name": "example.com",
"target": "ns-4567.awsdns-21.co.uk",
"isAlias": false,
"type": "NS"
},
{
"id": "-2107289565",
"name": "example.com",
"target": "ns-333.awsdns-22.net",
"isAlias": false,
"type": "NS"
},
{
"id": "1582095705",
"name": "example.com",
"target": "ns-1111.awsdns-51.org",
"isAlias": false,
"type": "NS"
},
{
"id": "-1769796132",
"name": "example.com",
"target": "ns-1234.awsdns-21.co.uk. awsdns-hostmaster.amazon.com. 1 7200 900 1209600 86400",
"isAlias": false,
"type": "SOA"
},
{
"id": "1029454894",
"name": "_dead6a124ede046a0319eb44a4eb3cbc.example.com",
"target": "_be133b0a0899fb7b6bf79d9741d1a383.hkvuiqjoua.acm-validations.aws",
"isAlias": false,
"type": "CNAME"
}
]
},
{
"name": "example.net",
"arn": "arn:aws:lightsail:global:111122223333:Domain/9c9f0d70-c92e-4753-86c2-6EXAMPLE029d",
"supportCode": "6EXAMPLE3362//hostedzone/ZEXAMPLE5TPKMV",
"createdAt": 1556661071.384,
"location": {
"availabilityZone": "all",
"regionName": "global"
},
"resourceType": "Domain",
"tags": [],
"domainEntries": [
{
"id": "-766320943",
"name": "example.net",
"target": "192.0.2.2",
"isAlias": false,
"type": "A"
},
{
"id": "-453913825",
"name": "example.net",
"target": "ns-123.awsdns-10.net",
"isAlias": false,
"type": "NS"
},
{
"id": "1553601564",
"name": "example.net",
"target": "ns-4444.awsdns-47.co.uk",
"isAlias": false,
"type": "NS"
},
{
"id": "1653797661",
"name": "example.net",
"target": "ns-7890.awsdns-61.org",
"isAlias": false,
"type": "NS"
},
{
"id": "706414698",
"name": "example.net",
"target": "ns-123.awsdns-44.com",
"isAlias": false,
"type": "NS"
},
{
"id": "337271745",
"name": "example.net",
"target": "ns-4444.awsdns-47.co.uk. awsdns-hostmaster.amazon.com. 1 7200 900 1209600 86400",
"isAlias": false,
"type": "SOA"
},
{
"id": "-1785431096",
"name": "www.example.net",
"target": "192.0.2.2",
"isAlias": false,
"type": "A"
}
]
},
{
"name": "example.org",
"arn": "arn:aws:lightsail:global:111122223333:Domain/f0f13ba3-3df0-4fdc-8ebb-1EXAMPLEf26e",
"supportCode": "6EXAMPLE3362//hostedzone/ZEXAMPLEAFO38",
"createdAt": 1556661199.106,
"location": {
"availabilityZone": "all",
"regionName": "global"
},
"resourceType": "Domain",
"tags": [],
"domainEntries": [
{
"id": "2065301345",
"name": "example.org",
"target": "192.0.2.4",
"isAlias": false,
"type": "A"
},
{
"id": "-447198516",
"name": "example.org",
"target": "ns-123.awsdns-45.com",
"isAlias": false,
"type": "NS"
},
{
"id": "136463022",
"name": "example.org",
"target": "ns-9999.awsdns-15.co.uk",
"isAlias": false,
"type": "NS"
},
{
"id": "1395941679",
"name": "example.org",
"target": "ns-555.awsdns-01.net",
"isAlias": false,
"type": "NS"
},
{
"id": "872052569",
"name": "example.org",
"target": "ns-6543.awsdns-38.org",
"isAlias": false,
"type": "NS"
},
{
"id": "1001949377",
"name": "example.org",
"target": "ns-1234.awsdns-15.co.uk. awsdns-hostmaster.amazon.com. 1 7200 900 1209600 86400",
"isAlias": false,
"type": "SOA"
},
{
"id": "1046191192",
"name": "www.example.org",
"target": "192.0.2.4",
"isAlias": false,
"type": "A"
}
]
}
]
}
Вывод
domains -> (список)
Массив пар ключ-значение, содержащих информацию о каждой записи домена в учетной записи пользователя.
(структура)
Описывает домен, где хранятся наборы записей.
name -> (строка)
arn -> (строка)
arn:aws:lightsail:global:123456789101:Domain/824cede0-abc7-4f84-8dbc-12345EXAMPLE).supportCode -> (строка)
createdAt -> (временная метка)
location -> (структура)
AWS регион и зоны доступности, где был создан набор записей домена.
availabilityZone -> (строка)
us-east-2a (регистрозависимо).regionName -> (строка)
resourceType -> (строка)
tags -> (список)
Ключи и необязательные значения тегов для ресурса. Дополнительную информацию о тегах в Lightsail см. в руководстве разработчика Amazon Lightsail.
(структура)
Описывает ключ тега и необязательное значение, назначенные ресурсу Amazon Lightsail.
Дополнительную информацию о тегах в Lightsail см. в руководстве разработчика Amazon Lightsail.
key -> (строка)
Ключ тега.
Ограничения: Ключи тегов принимают максимум 128 символов, цифр, пробелов в UTF-8 или следующих символов: + - = . _ : / @
value -> (строка)
Значение тега.
Ограничения: Значения тегов принимают максимум 256 символов, цифр, пробелов в UTF-8 или следующих символов: + - = . _ : / @
domainEntries -> (список)
Массив пар ключ-значение, содержащих информацию о записях домена.
(структура)
Описывает запись набора записей домена.
id -> (строка)
name -> (строка)
target -> (строка)
Целевой IP-адрес (192.0.2.0) или DNS-сервер 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), DNS-сервер (NS), начало зоны авторитета (SOA), локатор службы (SRV) или текст (TXT).
Можно использовать следующие типы записей домена:
AAAAACNAMEMXNSSOASRVTXT
options -> (карта)
(Устарело) Параметры записи домена.
Примечание
В выпусках до 29 ноября 2017 года этот параметр не включался в ответ API. Теперь он устарел.key -> (строка)
value -> (строка)
registeredDomainDelegationInfo -> (структура)
Объект, описывающий состояние делегирования домена Route 53 в зону DNS Lightsail.
nameServersUpdateState -> (структура)
Объект, описывающий состояние записей DNS-серверов, автоматически добавленных в домен Route 53 Lightsail.
code -> (строка)
Код состояния обновления записей DNS-серверов.
Возможные значения:
-
SUCCEEDED- Записи DNS-серверов были успешно обновлены. -
PENDING- Обновление записей DNS-сервера находится в процессе. -
FAILED- Обновление записей DNS-сервера завершилось ошибкой. -
STARTED- Автоматическое обновление записей DNS-серверов началось.
message -> (строка)
r53HostedZoneDeletionState -> (структура)
Описывает состояние удаления зоны Amazon Route 53 для домена, который автоматически делегируется в зону DNS Amazon Lightsail.
code -> (строка)
Код состояния удаления.
Возможные значения:
-
SUCCEEDED- Зона была успешно удалена. -
PENDING- Удаление зоны находится в процессе. -
FAILED- Удаление зоны завершилось ошибкой. -
STARTED- Удаление зоны началось.
message -> (строка)
nextPageToken -> (строка)
Токен для перехода к следующей странице результатов запроса.
Токен следующей страницы не возвращается, если больше результатов отобразить нельзя.
Чтобы получить следующую страницу результатов, выполните еще один запрос GetDomains и укажите токен следующей страницы, используя параметр pageToken.
© Copyright 2025, Amazon Web Services. Created using Sphinx.
