[ aws . compute-optimizer ]
get-lambda-function-recommendations
Описание
Возвращает рекомендации по функциям Lambda.
Compute Optimizer генерирует рекомендации для функций, которые соответствуют определенному набору требований. Дополнительную информацию см. в разделе Поддерживаемые ресурсы и требования в Руководстве пользователя Compute Optimizer.
См. также: Документация API AWS
get-lambda-function-recommendations это постраничная операция. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответ на постраничный запрос аргумент --query должен извлечь данные из результатов следующих выражений запроса: lambdaFunctionRecommendations
Синтаксис
get-lambda-function-recommendations
[--function-arns <value>]
[--account-ids <value>]
[--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]
Параметры
--function-arns (список)
Amazon Resource Name (ARN) функций, для которых требуется вернуть рекомендации.
Вы можете указать полное или краткое ARN. Если вы укажете краткое ARN без суффикса версии функции, Compute Optimizer вернёт рекомендации для последней ($LATEST) версии функции. Если вы укажете полное ARN с суффиксом версии, Compute Optimizer вернёт рекомендации для указанной версии функции. Дополнительную информацию об использовании версий см. в Руководстве разработчика Lambda в разделе Использование версий.
(строка)
Синтаксис:
"string" "string" ...
--account-ids (список)
Идентификатор учётной записи Amazon Web Services, для которого необходимо вернуть рекомендации по функциям.
Если ваша учётная запись является учётной записью управления организацией, используйте этот параметр для указания учётной записи участника, для которой вы хотите получить рекомендации по функциям.
В запросе может быть указан только один идентификатор учётной записи.
(строка)
Синтаксис:
"string" "string" ...
--filters (список)
Массив объектов для указания фильтра, возвращающего более конкретный список рекомендаций по функциям.
(структура)
Описывает фильтр, возвращающий более конкретный список рекомендаций по функциям Lambda. Используйте этот фильтр с действием GetLambdaFunctionRecommendations.
Вы можете использовать EBSFilter с действием GetEBSVolumeRecommendations, JobFilter с действием DescribeRecommendationExportJobs и Filter с действиями GetAutoScalingGroupRecommendations и GetEC2InstanceRecommendations.
name -> (строка)
Имя фильтра.
Укажите Finding, чтобы вернуть рекомендации с конкрейной классификацией обнаружений (например, NotOptimized).
Укажите FindingReasonCode, чтобы вернуть рекомендации с конкретным кодом причины обнаружения (например, MemoryUnderprovisioned).
Вы можете отфильтровать рекомендации по функциям Lambda по тегам tag:key и tag-key.
tag:key — это комбинация ключа и значения тега, назначенного вашим рекомендациям по функциям Lambda. Используйте ключ тега в имени фильтра и значение тега в качестве значения фильтра. Например, чтобы найти все рекомендации по функциям Lambda, имеющие тег с ключом Owner и значением TeamA, укажите tag:Owner для имени фильтра и TeamA для значения фильтра.
tag-key — это ключ тега, назначенного вашим рекомендациям по функциям Lambda. Используйте этот фильтр, чтобы найти все ваши рекомендации по функциям Lambda, имеющие тег с определённым ключом. Это не учитывает значение тега. Например, вы можете найти свои рекомендации по функциям Lambda с ключом тега Owner или без назначенных ключей тегов.
values -> (список)
Значение фильтра.
Допустимые значения для этого параметра зависят от того, что вы укажете для параметра name:
- Укажите
Optimized,NotOptimizedилиUnavailable, если вы укажите параметрnameкакFinding. - Укажите
MemoryOverprovisioned,MemoryUnderprovisioned,InsufficientDataилиInconclusive, если вы укажите параметрnameкакFindingReasonCode.
(строка)
Краткая форма синтаксиса:
name=string,values=string,string ...
Синтаксис JSON:
[
{
"name": "Finding"|"FindingReasonCode",
"values": ["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
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определённый профиль из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет параметры конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- включено
- выключено
- автоматически
--no-sign-request (булево)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.
--ca-bundle (строка)
Файл CA-сертификатов для использования при проверке сертификатов SSL. Переопределяет параметры конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (строка)
Стиль форматирования для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной строкой base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, отображающего двоичный блок, 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, когда больше нет страниц с рекомендациями функций для возврата.
lambdaFunctionRecommendations -> (список)
Массив объектов, описывающих рекомендации по функциям.
(структура)
Описывает рекомендацию по Lambda-функции.
functionArn -> (строка)
functionVersion -> (строка)
accountId -> (строка)
currentMemorySize -> (целое число)
numberOfInvocations -> (длинное целое число)
utilizationMetrics -> (список)
Массив объектов, описывающих метрики использования функции.
(структура)
Описывает метрику использования Lambda-функции.
name -> (строка)
Имя метрики использования.
Доступны следующие метрики использования:
-
Duration- Время, которое код вашей функции тратит на обработку события. -
Memory- Объем используемой памяти на вызов.
statistic -> (строка)
Статистика метрики использования.
API Compute Optimizer, командная строка (CLI) и SDK возвращают метрики использования только со статистикой Maximum, которая представляет собой наибольшее значение, наблюдаемое в течение указанного периода.
Консоль Compute Optimizer отображает графики для некоторых метрик использования, используя статистику Average, которая представляет собой значение Sum / SampleCount в течение указанного периода. Дополнительные сведения см. в руководстве пользователя Compute Optimizer. Также вы можете получить усредненные данные метрик использования для своих ресурсов с помощью Amazon CloudWatch. Дополнительные сведения см. в руководстве пользователя Amazon CloudWatch.
value -> (двойное число)
lookbackPeriodInDays -> (двойное число)
lastRefreshTimestamp -> (временная метка)
finding -> (строка)
Классификация вывода функции.
Выводы по функциям включают:
-
**
Optimized** — Функция правильно настроена для выполнения вашей рабочей нагрузки на основе текущей конфигурации и истории ее использования. Эта классификация вывода не включает коды причин вывода. -
**
NotOptimized** — Функция работает на более высоком (перенастроенном) или более низком (недостаточно настроенном) уровне, чем требуется для вашей рабочей нагрузки, поскольку ее текущая конфигурация не является оптимальной. Перенастроенные ресурсы могут привести к ненужным затратам на инфраструктуру, а недостаточно настроенные ресурсы могут привести к плохой производительности приложения. Эта классификация вывода может включать коды причин выводаMemoryUnderprovisionedиMemoryUnderprovisioned. -
**
Unavailable** — Compute Optimizer не смог сгенерировать рекомендацию для функции. Это может произойти из-за того, что функция не накопила достаточных данных метрик или функция не соответствует требованиям для рекомендации. Эта классификация вывода может включать коды причин выводаInsufficientDataиInconclusive.
Примечание
Функции с выводом недоступен не возвращаются, если вы не укажите параметрfilter со значением Unavailable в вашем запросе GetLambdaFunctionRecommendations.findingReasonCodes -> (список)
Причина классификации вывода функции.
Примечание
Функции с классификацией выводаOptimized не имеют кода причины вывода.Коды причин вывода для функций включают:
-
**
MemoryOverprovisioned** — Функция перенастроена, когда ее конфигурация памяти может быть уменьшена, при этом удовлетворяя требованиям к производительности вашей рабочей нагрузки. Перенастроенная функция может привести к ненужным затратам на инфраструктуру. Этот код причины вывода относится к классификации выводаNotOptimized. -
**
MemoryUnderprovisioned** — Функция недостаточно настроена, когда ее конфигурация памяти не соответствует требованиям к производительности рабочей нагрузки. Недостаточно настроенная функция может привести к плохой производительности приложения. Этот код причины вывода относится к классификации выводаNotOptimized. -
**
InsufficientData** — У функции недостаточно данных метрик для Compute Optimizer, чтобы сгенерировать рекомендацию. Дополнительные сведения см. в руководстве пользователя Compute Optimizer. -
**
Inconclusive** — Функция не соответствует требованиям для рекомендации, поскольку Compute Optimizer не может сгенерировать рекомендацию с высокой степенью уверенности. Этот код причины вывода относится к классификации выводаUnavailable.
(строка)
memorySizeRecommendationOptions -> (список)
Массив объектов, описывающих рекомендации по конфигурации памяти для функции.
(структура)
Описывает рекомендуемый вариант для Lambda-функции.
rank -> (целое число)
Рейтинг рекомендуемого варианта для функции.
Лучший рекомендуемый вариант имеет рейтинг 1.
memorySize -> (целое число)
projectedUtilizationMetrics -> (список)
Массив объектов, описывающих прогнозируемые метрики использования рекомендуемого варианта для функции.
(структура)
Описывает прогнозируемую метрику использования рекомендуемого варианта для Lambda-функции.
name -> (строка)
statistic -> (строка)
value -> (двойное число)
savingsOpportunity -> (структура)
Объект, описывающий возможность экономии для рекомендуемого варианта Lambda-функции. Возможность экономии включает в себя предполагаемую ежемесячную сумму экономии и процент.
savingsOpportunityPercentage -> (двойное число)
estimatedMonthlySavings -> (структура)
Объект, описывающий предполагаемую ежемесячную сумму экономии, возможную за счет принятия рекомендаций Compute Optimizer для данного ресурса. Это основано на ценах на экземпляры On-Demand.
currency -> (строка)
value -> (двойное число)
savingsOpportunityAfterDiscounts -> (структура)
Объект, описывающий возможность экономии для рекомендуемого варианта Lambda-функции, который включает скидки по планам экономии. Возможность экономии включает предполагаемую ежемесячную сумму экономии и процент.
savingsOpportunityPercentage -> (двойное число)
estimatedMonthlySavings -> (структура)
Предполагаемая ежемесячная экономия, возможная за счет принятия рекомендаций Compute Optimizer по Lambda-функциям. Это включает любые применимые скидки по планам экономии.
currency -> (строка)
value -> (двойное число)
currentPerformanceRisk -> (строка)
effectiveRecommendationPreferences -> (структура)
Описание эффективных предпочтений рекомендаций для Lambda-функций.
savingsEstimationMode -> (структура)
Описание режима оценки экономии, используемого для расчета возможностей экономии для Lambda-функций.
source -> (строка)
tags -> (список)
Список тегов, назначенных рекомендациям по Lambda-функциям.
(структура)
Список пар ключевых слов и значений тегов, которые вы определяете.
key -> (строка)
value -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.