list-nodes-summary
Описание
Генерирует сводку метаданных управляемых экземпляров/узлов на основе указанных фильтров и агрегаторов. Результаты сгруппированы по указанному агрегатору.
См. также: Документацию AWS API
list-nodes-summary — это операция с постраничной передачей. Для получения всего набора результатов может потребоваться несколько вызовов API. Вы можете отключить постраничную передачу, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной передачей аргумент --query должен извлекать данные из результатов следующих выражений запроса: Summary
Синтаксис
list-nodes-summary
[--sync-name <value>]
[--filters <value>]
--aggregators <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]
Параметры
--sync-name (строка)
Имя синхронизации данных управляемых ресурсов Amazon Web Services для получения информации.
Для конфигураций между аккаунтами/регионами этот параметр обязателен и должен содержать имя поддерживаемой синхронизации данных ресурсов — AWS-QuickSetup-ManagedNode.
Для конфигураций в рамках одного аккаунта/региона этот параметр необязателен.
--filters (список)
Один или несколько фильтров. Используйте фильтр для генерации сводки, соответствующей указанным критериям фильтра.
(структура)
Фильтры для операции.
Ключ -> (строка)
Значения -> (список)
Значение фильтра, поддерживаемое указанным ключом. Например, для ключа PlatformType поддерживаемые значения включают Linux и Windows.
(строка)
Тип -> (строка)
Сокращённый синтаксис:
Key=string,Values=string,string,Type=string ...
Синтаксис JSON:
[
{
"Key": "AgentType"|"AgentVersion"|"ComputerName"|"InstanceId"|"InstanceStatus"|"IpAddress"|"ManagedStatus"|"PlatformName"|"PlatformType"|"PlatformVersion"|"ResourceType"|"OrganizationalUnitId"|"OrganizationalUnitPath"|"Region"|"AccountId",
"Values": ["string", ...],
"Type": "Equal"|"NotEqual"|"BeginWith"
}
...
]
--aggregators (список)
Укажите один или несколько агрегаторов, чтобы получить количество управляемых узлов, соответствующих заданному выражению. Например, количество управляемых узлов по операционной системе.
(структура)
Один или несколько агрегаторов для просмотра подсчёта узлов по различным измерениям.
AggregatorType -> (строка)
Count.TypeName -> (строка)
Instance.AttributeName -> (строка)
Aggregators -> (список)
Информация об агрегаторах, используемых для уточнения сводки узлов.
(структура)
Один или несколько агрегаторов для просмотра подсчёта узлов по различным измерениям.
AggregatorType -> (строка)
Count.TypeName -> (строка)
Instance.AttributeName -> (строка)
Сокращённый синтаксис:
AggregatorType=string,TypeName=string,AttributeName=string,Aggregators=[{AggregatorType=string,TypeName=string,AttributeName=string,( ... recursive ... )},{AggregatorType=string,TypeName=string,AttributeName=string,( ... recursive ... )}] ...
Синтаксис JSON:
[
{
"AggregatorType": "Count",
"TypeName": "Instance",
"AttributeName": "AgentVersion"|"PlatformName"|"PlatformType"|"PlatformVersion"|"Region"|"ResourceType",
"Aggregators": [
{
"AggregatorType": "Count",
"TypeName": "Instance",
"AttributeName": "AgentVersion"|"PlatformName"|"PlatformType"|"PlatformVersion"|"Region"|"ResourceType",
"Aggregators":
}
...
]
}
...
]
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределяют значения, полученные из JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет интерпретирована буквально. Это не может быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Токен для указания точки начала постраничной передачи. Это NextToken из ранее обрезанного ответа.
Примеры использования см. в разделе Постраничная передача в руководстве пользователя AWS CLI.
--page-size (целое число)
Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить таймауты вызовов AWS-сервиса.
Примеры использования см. в разделе Постраничная передача в руководстве пользователя AWS CLI.
--max-items (целое число)
Общее количество элементов, возвращаемых в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для продолжения постраничной передачи укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.
Примеры использования см. в разделе Постраничная передача в руководстве пользователя AWS CLI.
--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.
Вывод
Summary -> (список)
Коллекция объектов, содержащих информацию о ваших управляемых узлах, например, количество узлов по операционной системе.
(карта)
ключ -> (строка)
значение -> (строка)
NextToken -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.
|
|