Spec-Zone.ru › AWS CLI v2

[ aws . devops-guru ]

list-recommendations

Описание

Возвращает список рекомендаций для указанного инсайта. Каждая рекомендация включает список связанных метрик и список связанных событий.

См. также: Документацию API AWS

list-recommendations является постраничной операцией. Для получения всего набора результатов могут быть отправлены несколько вызовов API. Вы можете отключить постраничность, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответе постраничной операции аргумент --query должен извлекать данные из результатов следующих выражений запроса: Recommendations

Синтаксис

  list-recommendations
--insight-id <value>
[--locale <value>]
[--account-id <value>]
[--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]

Параметры

--insight-id (строка)

Идентификатор запрашиваемого инсайта.

--locale (строка)

Локаль, определяющая язык для использования в рекомендациях.

Возможные значения:

  • DE_DE
  • EN_US
  • EN_GB
  • ES_ES
  • FR_FR
  • IT_IT
  • JA_JP
  • KO_KR
  • PT_BR
  • ZH_CN
  • ZH_TW

--account-id (строка)

Идентификатор учетной записи Amazon Web Services.

--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
  • 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 для вывода.

--cli-auto-prompt (логическое значение)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запросы параметров ввода CLI.

Вывод

Рекомендации -> (список)

Массив запрошенных рекомендаций.

(структура)

Информация о рекомендации, помогающая исправить выявленное аномальное поведение, которое привело к инсайту.

Описание -> (строка)

Описание проблемы.

Ссылка -> (строка)

Гиперссылка на информацию, которая поможет решить проблему.

Имя -> (строка)

Название рекомендации.

Причина -> (строка)

Причина, по которой DevOps Guru обозначил аномальное поведение как проблему.

Связанные события -> (список)

События, связанные с проблемой. Используйте эти события, чтобы узнать больше о происходящем и помочь решить проблему.

(структура)

Информация о событии, связанном с рекомендацией.

Имя -> (строка)

Название события. Соответствует полю Name в объекте Event.

Ресурсы -> (список)

Объект ResourceCollection, содержащий массивы имен стеков Amazon Web Services CloudFormation. Вы можете указать до 500 стеков Amazon Web Services CloudFormation.

(структура)

Информация об Amazon Web Services-ресурсе, который выпустил событие, связанное с рекомендацией в инсайте.

Имя -> (строка)

Имя ресурса, который выпустил событие. Соответствует полю Name в объекте EventResource.

Тип -> (строка)

Тип ресурса, который выпустил событие. Соответствует полю Type в объекте EventResource.

Связанные аномалии -> (список)

Аномалии, связанные с проблемой. Используйте эти аномалии, чтобы узнать больше о происходящем и помочь решить проблему.

(структура)

Информация об аномалии, связанной с рекомендацией.

Ресурсы -> (список)

Массив объектов, представляющих ресурсы, в которых DevOps Guru обнаружил аномальное поведение. Каждый объект содержит имя и тип ресурса.

(структура)

Информация о ресурсе, в котором DevOps Guru обнаружил аномальное поведение.

Имя -> (строка)

Имя ресурса.

Тип -> (строка)

Тип ресурса. Типы ресурсов принимают тот же вид, что и идентификаторы типов ресурсов Amazon Web Services CloudFormation, service-provider::service-name::data-type-name. Например, AWS::RDS::DBCluster. Более подробную информацию см. в справке по типам ресурсов и свойств Amazon Web Services в Руководстве пользователя Amazon Web Services CloudFormation.

Подробности источника -> (список)

Информация о том, где было обнаружено аномальное поведение, связанное с рекомендацией. Например, детали в метриках Amazon CloudWatch.

(структура)

Содержит массив объектов RecommendationRelatedCloudWatchMetricsSourceDetail, содержащих имя и пространство имен метрики Amazon CloudWatch.

Метрики CloudWatch -> (список)

Массив объектов CloudWatchMetricsDetail, содержащих информацию об анализируемых метриках, которые проявили аномальное поведение.

(структура)

Информация об Amazon CloudWatch метрике, которая анализируется DevOps Guru. Это одна из многих анализируемых метрик, используемых для генерации инсайтов.

Имя метрики -> (строка)

Имя метрики CloudWatch.

Пространство имен -> (строка)

Пространство имен метрики CloudWatch. Пространство имен — это контейнер для метрик CloudWatch.

Идентификатор аномалии -> (строка)

Идентификатор аномалии, которая породила инсайт с этой рекомендацией.

Категория -> (строка)

Тип категории рекомендации.

NextToken -> (строка)

Токен постраничной обработки для получения следующей страницы результатов для этой операции. Если больше страниц нет, это значение равно null.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API