Spec-Zone.ru › AWS CLI v2

[ aws . compute-optimizer ]

get-recommendation-summaries

Описание

Возвращает результаты оптимизации для учетной записи.

Возвращает количество:

  • виртуальных машин Amazon EC2 в учетной записи, которые являются Underprovisioned , Overprovisioned , или Optimized .
  • групп автоматического масштабирования в учетной записи, которые являются NotOptimized , или Optimized .
  • томов Amazon EBS в учетной записи, которые являются NotOptimized , или Optimized .
  • функций Lambda в учетной записи, которые являются NotOptimized , или Optimized .
  • сервисов Amazon ECS в учетной записи, которые являются Underprovisioned , Overprovisioned , или Optimized .

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

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

Синтаксис

  get-recommendation-summaries
[--account-ids <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]

Параметры

--account-ids (список)

ID учетной записи Amazon Web Services, для которой необходимо вернуть сводки рекомендаций.

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

В каждом запросе может быть указан только один идентификатор учетной записи.

(строка)

Синтаксис:

"string" "string" ...

--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.

Вывод

nextToken -> (строка)

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

Это значение равно null, если больше нет страниц сводок рекомендаций для возврата.

recommendationSummaries -> (список)

Массив объектов, обобщающих рекомендацию.

(структура)

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

summaries -> (список)

Массив объектов, описывающих сводку рекомендации.

(структура)

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

name -> (строка)

Классификация выявленной проблемы рекомендации.

value -> (число с плавающей запятой)

Значение сводки рекомендации.

reasonCodeSummaries -> (список)

Массив объектов, обобщающих код причины проблемы.

(структура)

Сводка кода причины проблемы.

name -> (строка)

Имя кода причины проблемы.

value -> (число с плавающей запятой)

Значение сводки кода причины проблемы.

idleSummaries -> (список)

Описание сводки выявленных проблем для неактивных ресурсов.

(структура)

Описание сводки выявленных проблем для неактивных ресурсов.

name -> (строка)

Имя группы выявленных проблем для неактивных ресурсов.

value -> (число)

Количество неактивных ресурсов в группе выявленных проблем.

recommendationResourceType -> (строка)

Тип ресурса, к которому относится сводка рекомендации.

accountId -> (строка)

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

savingsOpportunity -> (структура)

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

savingsOpportunityPercentage -> (число с плавающей запятой)

Оценочная ежемесячная экономия в процентах от ежемесячных затрат при принятии рекомендаций Compute Optimizer для данного ресурса.

estimatedMonthlySavings -> (структура)

Объект, описывающий оценочную ежемесячную сумму экономии, которую можно получить при принятии рекомендаций Compute Optimizer для данного ресурса. Основано на ценах на экземпляры On-Demand.

currency -> (строка)

Валюта оценочной ежемесячной экономии.

value -> (число с плавающей запятой)

Значение оценочной ежемесячной экономии.

idleSavingsOpportunity -> (структура)

Описание возможности экономии для рекомендаций данного типа ресурса или для варианта рекомендации отдельного ресурса.

Возможность экономии представляет собой оценочную ежемесячную экономию, которую вы можете получить, реализовав данную рекомендацию Compute Optimizer.

Предупреждение

Данные о возможности экономии требуют включения Cost Explorer, а также активации параметра Получать рекомендации по ресурсам Amazon EC2 в настройках Cost Explorer. Это создает связь между Cost Explorer и Compute Optimizer. Благодаря этой связи Cost Explorer генерирует оценки экономии, учитывая стоимость существующих ресурсов, стоимость рекомендуемых ресурсов и данные об историческом использовании. Оценочная ежемесячная экономия отражает прогнозируемую экономию в денежном выражении, связанную с каждой сгенерированной рекомендацией. Дополнительную информацию см. в руководстве по управлению затратами «Включение Cost Explorer и оптимизация затрат с помощью рекомендаций по переконфигурации».

savingsOpportunityPercentage -> (число с плавающей запятой)

Оценочная ежемесячная экономия в процентах от ежемесячных затрат при принятии рекомендаций Compute Optimizer для данного ресурса.

estimatedMonthlySavings -> (структура)

Объект, описывающий оценочную ежемесячную сумму экономии, которую можно получить при принятии рекомендаций Compute Optimizer для данного ресурса. Основано на ценах на экземпляры On-Demand.

currency -> (строка)

Валюта оценочной ежемесячной экономии.

value -> (число с плавающей запятой)

Значение оценочной ежемесячной экономии.

aggregatedSavingsOpportunity -> (структура)

Описание возможности экономии для рекомендаций данного типа ресурса или для варианта рекомендации отдельного ресурса.

Возможность экономии представляет собой оценочную ежемесячную экономию, которую вы можете получить, реализовав данную рекомендацию Compute Optimizer.

Предупреждение

Данные о возможности экономии требуют включения Cost Explorer, а также активации параметра Получать рекомендации по ресурсам Amazon EC2 в настройках Cost Explorer. Это создает связь между Cost Explorer и Compute Optimizer. Благодаря этой связи Cost Explorer генерирует оценки экономии, учитывая стоимость существующих ресурсов, стоимость рекомендуемых ресурсов и данные об историческом использовании. Оценочная ежемесячная экономия отражает прогнозируемую экономию в денежном выражении, связанную с каждой сгенерированной рекомендацией. Дополнительную информацию см. в руководстве по управлению затратами «Включение Cost Explorer и оптимизация затрат с помощью рекомендаций по переконфигурации».

savingsOpportunityPercentage -> (число с плавающей запятой)

Оценочная ежемесячная экономия в процентах от ежемесячных затрат при принятии рекомендаций Compute Optimizer для данного ресурса.

estimatedMonthlySavings -> (структура)

Объект, описывающий оценочную ежемесячную сумму экономии, которую можно получить при принятии рекомендаций Compute Optimizer для данного ресурса. Основано на ценах на экземпляры On-Demand.

currency -> (строка)

Валюта оценочной ежемесячной экономии.

value -> (число с плавающей запятой)

Значение оценочной ежемесячной экономии.

currentPerformanceRiskRatings -> (структура)

Объект, описывающий рейтинги риска производительности для данного типа ресурса.

high -> (целое число)

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

medium -> (целое число)

Количество соответствующих типов ресурсов со средним рейтингом риска производительности.

low -> (целое число)

Количество соответствующих типов ресурсов с низким рейтингом риска производительности.

veryLow -> (целое число)

Количество соответствующих типов ресурсов с очень низким рейтингом риска производительности.

inferredWorkloadSavings -> (список)

Массив объектов, описывающих оценочные ежемесячные суммы экономии для экземпляров, работающих на указанных inferredWorkloadTypes. Массив содержит пять лучших возможностей экономии для экземпляров, выполняющих выявленные типы рабочих нагрузок.

(структура)

Оценочная ежемесячная экономия после корректировки конфигураций ваших экземпляров, работающих на выявленных типах рабочих нагрузок, до рекомендуемых конфигураций. Если список inferredWorkloadTypes содержит несколько записей, экономия является суммой ежемесячной экономии от экземпляров, выполняющих точную комбинацию выявленных типов рабочих нагрузок.

inferredWorkloadTypes -> (список)

Приложения, которые могут выполняться на экземпляре, как определено Compute Optimizer.

Compute Optimizer может определить, возможно ли выполнение одного из следующих приложений на экземпляре:

  • AmazonEmr - Определяет, что Amazon EMR может выполняться на экземпляре.
  • ApacheCassandra - Определяет, что Apache Cassandra может выполняться на экземпляре.
  • ApacheHadoop - Определяет, что Apache Hadoop может выполняться на экземпляре.
  • Memcached - Определяет, что Memcached может выполняться на экземпляре.
  • NGINX - Определяет, что NGINX может выполняться на экземпляре.
  • PostgreSql - Определяет, что PostgreSQL может выполняться на экземпляре.
  • Redis - Определяет, что Redis может выполняться на экземпляре.
  • Kafka - Определяет, что Kafka может выполняться на экземпляре.
  • SQLServer - Определяет, что SQLServer может выполняться на экземпляре.

(строка)

estimatedMonthlySavings -> (структура)

Объект, описывающий оценочную ежемесячную сумму экономии, которую можно получить при принятии рекомендаций Compute Optimizer для данного ресурса. Основано на ценах на экземпляры On-Demand.

currency -> (строка)

Валюта оценочной ежемесячной экономии.

value -> (число с плавающей запятой)

Значение оценочной ежемесячной экономии.

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

Spec-Zone.ru

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