Spec-Zone.ru › AWS CLI v2

[ 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 -> (строка)

Amazon Resource Name (ARN) текущей функции.

functionVersion -> (строка)

Номер версии текущей функции.

accountId -> (строка)

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

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 -> (двойное число)

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

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

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

currency -> (строка)

Валюта предполагаемой ежемесячной экономии.

value -> (двойное число)

Значение предполагаемой ежемесячной экономии.

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

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

savingsOpportunityPercentage -> (двойное число)

Предполагаемый ежемесячный процент экономии от ежемесячных расходов за счет принятия рекомендаций Compute Optimizer по Lambda-функциям. Это включает любые применимые скидки по планам экономии.

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

Предполагаемая ежемесячная экономия, возможная за счет принятия рекомендаций Compute Optimizer по Lambda-функциям. Это включает любые применимые скидки по планам экономии.

currency -> (строка)

Валюта предполагаемой ежемесячной экономии.

value -> (двойное число)

Значение предполагаемой ежемесячной экономии.

currentPerformanceRisk -> (строка)

Риск того, что текущая Lambda-функция не удовлетворит потребностям производительности своих рабочих нагрузок. Чем выше риск, тем более вероятно, что текущая Lambda-функция требует больше памяти.

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

Описание эффективных предпочтений рекомендаций для Lambda-функций.

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

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

source -> (строка)

Описание источника для расчета возможностей экономии для Lambda-функций.

tags -> (список)

Список тегов, назначенных рекомендациям по Lambda-функциям.

(структура)

Список пар ключевых слов и значений тегов, которые вы определяете.

key -> (строка)

Одна часть пары ключ-значение, составляющей тег. Ключ — это общее обозначение, которое действует как категория для более конкретных значений тега.

value -> (строка)

Одна часть пары ключ-значение, составляющей тег. Значение действует как описатель в категории тега (ключ). Значение может быть пустым или нулевым.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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