[ aws . servicediscovery ]
list-namespaces
Описание
Отображает сводную информацию о пространствах имён, созданных текущей учётной записью Amazon Web Services.
См. также: Документация API AWS
list-namespaces является постраничной операцией. Для получения всего набора результатов могут потребоваться несколько вызовов API. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничностью, аргумент --query должен извлекать данные из результатов следующих выражений запроса: Namespaces
Синтаксис
list-namespaces
[--filters <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <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]
Параметры
--filters (список)
Сложный тип, содержащий спецификации для пространств имён, которые вы хотите перечислить.
Если вы указываете более одного фильтра, пространство имён должно соответствовать всем фильтрам, чтобы быть возвращённым ListNamespaces.
(структура)
Сложный тип, определяющий пространства имён, которые вы хотите перечислить. Вы можете выбрать перечисление публичных или частных пространств имён.
Имя -> (строка)
Укажите пространства имён, которые вы хотите получить, используя один из следующих вариантов.
-
TYPE: Получает пространства имён указанного типа. -
NAME: Получает пространства имён с указанным именем. -
HTTP_NAME: Получает пространства имён с указанным HTTP-именем.
Значения -> (список)
Укажите значения, применимые к значению, которое вы указываете для Name.
-
TYPE: УкажитеHTTP,DNS_PUBLICилиDNS_PRIVATE. -
NAME: Укажите имя пространства имён, которое находится вNamespace.Name. -
HTTP_NAME: Укажите HTTP-имя пространства имён, которое находится вNamespace.Properties.HttpProperties.HttpName.
(строка)
Условие -> (строка)
Укажите оператор, который вы хотите использовать, чтобы определить, соответствует ли пространство имён указанному значению. Допустимые значения для Condition включают следующие.
-
EQ: Когда вы указываетеEQдляCondition, вы можете указать только одно значение.EQподдерживается дляTYPE,NAMEиHTTP_NAME.EQявляется условием по умолчанию и может быть опущено. -
BEGINS_WITH: Когда вы указываетеBEGINS_WITHдляCondition, вы можете указать только одно значение.BEGINS_WITHподдерживается дляTYPE,NAMEиHTTP_NAME.
Упрощённый синтаксис:
Name=string,Values=string,string,Condition=string ...
Синтаксис JSON:
[
{
"Name": "TYPE"|"NAME"|"HTTP_NAME",
"Values": ["string", ...],
"Condition": "EQ"|"IN"|"BETWEEN"|"BEGINS_WITH"
}
...
]
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения перепишут значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения, используя предоставленное значение JSON, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Маркер для указания точки начала постраничной навигации. Это NextToken из ранее обрезанного ответа.
Примеры использования см. в разделе Постраничная навигация в Руководстве пользователя AWS Command Line Interface.
--page-size (целое число)
Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.
Примеры использования см. в разделе Постраничная навигация в Руководстве пользователя 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
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для использования при фильтрации данных ответа.
--profile (строка)
Использовать определённый профиль из файла учетных данных.
--region (строка)
Использовать указанный регион. Переопределяет настройки конфигурации/окружения.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- on
- off
- auto
--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.
Для перечисления пространств имён
Следующий list-namespaces пример перечисляет пространства имён.
aws servicediscovery list-namespaces
Вывод:
{
"Namespaces": [
{
"Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-a3ccy2e7e3a7rile",
"CreateDate": 1585354387.357,
"Id": "ns-a3ccy2e7e3a7rile",
"Name": "local",
"Properties": {
"DnsProperties": {
"HostedZoneId": "Z06752353VBUDTC32S84S"
},
"HttpProperties": {
"HttpName": "local"
}
},
"Type": "DNS_PRIVATE"
},
{
"Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-pocfyjtrsmwtvcxx",
"CreateDate": 1586468974.698,
"Description": "My second namespace",
"Id": "ns-pocfyjtrsmwtvcxx",
"Name": "My-second-namespace",
"Properties": {
"DnsProperties": {},
"HttpProperties": {
"HttpName": "My-second-namespace"
}
},
"Type": "HTTP"
},
{
"Arn": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-ylexjili4cdxy3xm",
"CreateDate": 1587055896.798,
"Id": "ns-ylexjili4cdxy3xm",
"Name": "example.com",
"Properties": {
"DnsProperties": {
"HostedZoneId": "Z09983722P0QME1B3KC8I"
},
"HttpProperties": {
"HttpName": "example.com"
}
},
"Type": "DNS_PRIVATE"
}
]
}
Дополнительную информацию см. в разделе Просмотр списка пространств имён в Руководстве разработчика AWS Cloud Map.
Вывод
Пространства имён -> (список)
Массив, содержащий по одному объекту NamespaceSummary для каждого пространства имён, соответствующего заданным критериям фильтрации.
(структура)
Сложный тип, содержащий информацию о пространстве имён.
Id -> (строка)
Arn -> (строка)
Name -> (строка)
Type -> (строка)
Description -> (строка)
ServiceCount -> (целое число)
Properties -> (структура)
Свойства пространства имён.
DnsProperties -> (структура)
Сложный тип, содержащий ID зоны размещения Route 53, которую Cloud Map создаёт при создании пространства имён.
HostedZoneId -> (строка)
SOA -> (структура)
Запись Start of Authority (SOA) для зоны размещения.
TTL -> (длинное целое число)
HttpProperties -> (структура)
Сложный тип, содержащий имя пространства имён HTTP.
HttpName -> (строка)
CreateDate -> (метка времени)
NextToken -> (строка)
Если ответ содержит NextToken , отправьте другой запрос ListNamespaces для получения следующей группы результатов. Укажите значение NextToken из предыдущего ответа в следующем запросе.
Примечание
Cloud Map получаетMaxResults пространств имён и затем фильтрует их на основе заданных критериев. Возможен случай, что ни одно пространство имён в первой MaxResults группе пространств имён не соответствует заданным критериям, но последующие группы MaxResults пространств имён могут содержать пространства имён, соответствующие критериям.
© Copyright 2025, Amazon Web Services. Created using Sphinx.