Spec-Zone.ru › AWS CLI v2

[ aws . compute-optimizer ]

get-ecs-service-recommendations

Описание

Возвращает рекомендации по службам Amazon ECS.

Compute Optimizer генерирует рекомендации для служб Amazon ECS на Fargate, которые соответствуют определённому набору требований. Дополнительную информацию см. в разделе Поддерживаемые ресурсы и требования в Руководстве пользователя Compute Optimizer.

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

Синтаксис

  get-ecs-service-recommendations
[--service-arns <value>]
[--next-token <value>]
[--max-results <value>]
[--filters <value>]
[--account-ids <value>]
[--cli-input-json | --cli-input-yaml]
[--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]

Параметры

--service-arns (список)

ARN, идентифицирующий службу Amazon ECS.

Следующий формат ARN:

arn:aws:ecs:region:aws_account_id:service/cluster-name/service-name

(строка)

Синтаксис:

"string" "string" ...

--next-token (строка)

Токен для перехода к следующей странице рекомендаций по службам Amazon ECS.

--max-results (целое число)

Максимальное количество рекомендаций по службам Amazon ECS, возвращаемых за один запрос.

Для получения оставшихся результатов выполните другой запрос с возвращённым значением nextToken.

--filters (список)

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

(структура)

Описывает фильтр, который возвращает более конкретный список рекомендаций по службам Amazon ECS. Используйте этот фильтр с действием GetECSServiceRecommendations.

name -> (строка)

Имя фильтра.

Укажите Finding, чтобы получить рекомендации с определённой классификацией результата.

Укажите FindingReasonCode, чтобы получить рекомендации с определённым кодом причины результата.

Вы можете отфильтровать рекомендации по службам Amazon ECS по тегам tag:key и tag-key.

tag:key — это комбинация ключа и значения тега, присвоенного рекомендациям по службам Amazon ECS. Используйте ключ тега в имени фильтра, а значение тега — в качестве значения фильтра. Например, чтобы найти все рекомендации по службам Amazon ECS, имеющие тег с ключом Owner и значением TeamA, укажите tag:Owner для имени фильтра и TeamA для значения фильтра.

tag-key — это ключ тега, присвоенного рекомендациям по службам Amazon ECS. Используйте этот фильтр, чтобы найти все рекомендации по службам Amazon ECS, имеющие тег с определённым ключом. Это не учитывает значение тега. Например, вы можете найти рекомендации по службам Amazon ECS с ключом тега Owner или без присвоенных ключей тегов.

values -> (список)

Значение фильтра.

Допустимые значения для этого параметра следующие:

  • Если вы укажете параметр name как Finding, укажите Optimized, Underprovisioned или Overprovisioned.
  • Если вы укажете параметр name как FindingReasonCode, укажите CPUUnderprovisioned, CPUOverprovisioned, MemoryUnderprovisioned или MemoryOverprovisioned.

(строка)

Сокращённый синтаксис:

name=string,values=string,string ...

Синтаксис JSON:

[
  {
    "name": "Finding"|"FindingReasonCode",
    "values": ["string", ...]
  }
  ...
]

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

Возвращает рекомендации по службам Amazon ECS для указанных идентификаторов учётных записей Amazon Web Services.

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

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

(строка)

Синтаксис:

"string" "string" ...

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному в --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет интерпретироваться буквально. Это не может быть указано вместе с --cli-input-yaml.

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

Вывод

nextToken -> (строка)

Токен для перехода к следующей странице рекомендаций по службам Amazon ECS.

ecsServiceRecommendations -> (список)

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

(структура)

Описание рекомендации по службе Amazon ECS.

serviceArn -> (строка)

Amazon Resource Name (ARN) текущей службы Amazon ECS.

Следующий формат ARN:

arn:aws:ecs:region:aws_account_id:service/cluster-name/service-name

accountId -> (строка)

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

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

Настройка текущей службы Amazon ECS.

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

Объем памяти, используемой задачами в службе Amazon ECS.

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

Количество процессорных ядер, используемых задачами в службе Amazon ECS.

containerConfigurations -> (список)

Настройки контейнеров в задаче службы Amazon ECS.

(структура)

Описание настроек контейнеров в задачах вашей службы Amazon ECS.

containerName -> (строка)

Имя контейнера.

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

Настройки размера памяти для контейнера.

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

Объем памяти в контейнере.

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

Предел резервирования памяти для контейнера.

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

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

autoScalingConfiguration -> (строка)

Описание методов настройки автоматического масштабирования для службы Amazon ECS. Это влияет на сгенерированные рекомендации. Например, если для службы Amazon ECS настроено автоматическое масштабирование по процессору, Compute Optimizer не генерирует рекомендации по размеру процессора.

Методы настройки автоматического масштабирования включают:

  • TARGET_TRACKING_SCALING_CPU — Если служба Amazon ECS настроена на использование целевого масштабирования по процессору, Compute Optimizer не генерирует рекомендации по процессору.
  • TARGET_TRACKING_SCALING_MEMORY — Если служба Amazon ECS настроена на использование целевого масштабирования по памяти, Compute Optimizer не генерирует рекомендации по памяти.

Дополнительную информацию о масштабировании шагами и целевом масштабировании см. в руководстве пользователя Application Auto Scaling по политикам масштабирования шагами для Application Auto Scaling и политикам целевого масштабирования для Application Auto Scaling.

taskDefinitionArn -> (строка)

ARN определения задачи, используемого задачами в службе Amazon ECS.

utilizationMetrics -> (список)

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

(структура)

Описание метрики использования службы Amazon ECS.

Для определения разницы в производительности между вашей текущей службой Amazon ECS и рекомендуемым вариантом сравните данные метрики использования вашей службы с прогнозируемыми данными метрики использования.

name -> (строка)

Имя метрики использования.

Доступны следующие метрики использования:

  • Cpu — Количество используемой процессорной мощности в службе.
  • Memory — Объем используемой памяти в службе.

statistic -> (строка)

Статистика метрики использования.

API, командная строка (CLI) и SDK Compute Optimizer возвращают метрики использования, используя только статистику Maximum, которая является максимальным значением, наблюдаемым в течение указанного периода.

Консоль Compute Optimizer отображает графики для некоторых метрик использования, используя статистику Average, которая является значением Sum / SampleCount в течение указанного периода. Дополнительную информацию см. в руководстве пользователя Compute Optimizer по просмотру рекомендаций по ресурсам. Вы также можете получить усредненные данные метрик использования для ваших ресурсов с помощью Amazon CloudWatch. Дополнительную информацию см. в руководстве пользователя Amazon CloudWatch.

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

Значение метрики использования.

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

Количество дней, в течение которых анализировались метрики использования службы Amazon ECS.

launchType -> (строка)

Тип запуска, используемый службой Amazon ECS.

Примечание

Compute Optimizer поддерживает только тип запуска Fargate.

lastRefreshTimestamp -> (метка времени)

Марка времени последнего обновления рекомендации по службе Amazon ECS.

finding -> (строка)

Классификация результата для службы Amazon ECS.

Результаты для служб Amazon ECS включают:

  • **Underprovisioned ** — Когда Compute Optimizer обнаруживает недостаток памяти или процессорной мощности, служба Amazon ECS считается недоукомплектованной. Недоукомплектованная служба может привести к низкой производительности приложения.
  • **Overprovisioned ** — Когда Compute Optimizer обнаруживает избыток памяти или процессорной мощности, служба Amazon ECS считается переукомплектованной. Переукомплектованная служба может привести к дополнительным затратам на инфраструктуру.
  • **Optimized ** — Когда и процессор, и память вашей службы Amazon ECS соответствуют требованиям производительности вашей рабочей нагрузки, служба считается оптимизированной.

findingReasonCodes -> (список)

Причина классификации результата для службы Amazon ECS.

Причины кодов результатов для служб Amazon ECS включают:

  • **CPUUnderprovisioned ** — Конфигурацию процессора службы можно увеличить, чтобы повысить производительность рабочей нагрузки. Это определяется путем анализа метрики CPUUtilization текущей службы в течение периода обратного отсчета.
  • **CPUOverprovisioned ** — Конфигурацию процессора службы можно уменьшить, при этом по-прежнему удовлетворяя требованиям производительности рабочей нагрузки. Это определяется путем анализа метрики CPUUtilization текущей службы в течение периода обратного отсчета.
  • **MemoryUnderprovisioned ** — Конфигурацию памяти службы можно увеличить, чтобы повысить производительность рабочей нагрузки. Это определяется путем анализа метрики MemoryUtilization текущей службы в течение периода обратного отсчета.
  • **MemoryOverprovisioned ** — Конфигурацию памяти службы можно уменьшить, при этом по-прежнему удовлетворяя требованиям производительности рабочей нагрузки. Это определяется путем анализа метрики MemoryUtilization текущей службы в течение периода обратного отсчета.

(строка)

serviceRecommendationOptions -> (список)

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

(структура)

Описание вариантов рекомендаций для службы Amazon ECS.

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

Размер памяти для варианта рекомендации службы Amazon ECS.

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

Размер процессора для варианта рекомендации службы Amazon ECS.

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

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

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

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

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

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

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

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

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

currency -> (строка)

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

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

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

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

Описание возможности экономии для рекомендаций службы Amazon ECS или для варианта рекомендации.

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

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

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

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

Ожидаемая ежемесячная экономия при принятии рекомендаций Compute Optimizer для службы Amazon ECS. Включает любые применимые скидки по планам экономии.

currency -> (строка)

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

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

Значение оценочной ежемесячной экономии для служб Amazon ECS.

projectedUtilizationMetrics -> (список)

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

(структура)

Описание прогнозируемых метрик использования варианта рекомендации службы Amazon ECS.

Чтобы определить разницу в производительности между вашей текущей службой Amazon ECS и рекомендованным вариантом, сравните данные об использовании метрик вашей службы с прогнозируемыми данными об использовании метрик.

name -> (строка)

Имя прогнозируемой метрики использования.

Доступны следующие метрики использования:

  • Cpu — Процент выделенных вычислительных единиц, которые в настоящее время используются в задачах службы.
  • Memory — Процент памяти, которая в настоящее время используется в задачах службы.

statistic -> (строка)

Статистика прогнозируемой метрики использования.

API, командная строка (CLI) и SDK Compute Optimizer возвращают метрики использования, используя только статистику Maximum, которая является наибольшим значением, наблюдаемым в течение указанного периода.

Консоль Compute Optimizer отображает графики для некоторых метрик использования, используя статистику Average, которая является значением Sum / SampleCount в течение указанного периода. Более подробную информацию см. в руководстве Руководство пользователя Compute Optimizer в разделе «Просмотр рекомендаций по ресурсам». Вы также можете получить данные о средних метриках использования ресурсов с помощью Amazon CloudWatch. Более подробную информацию см. в руководстве пользователя Amazon CloudWatch.

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

Нижние граничные значения для прогнозируемых метрик использования.

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

Верхние граничные значения для прогнозируемых метрик использования.

containerRecommendations -> (список)

Рекомендации по размеру процессора и памяти для контейнеров в задаче вашей службы Amazon ECS.

(структура)

Рекомендации по размеру процессора и памяти для контейнера в задачах вашей службы Amazon ECS.

containerName -> (строка)

Имя контейнера.

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

Рекомендованные конфигурации размера памяти для контейнера.

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

Объем памяти в контейнере.

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

Предел резервирования памяти для контейнера.

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

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

currentPerformanceRisk -> (строка)

Риск того, что текущая служба Amazon ECS не будет соответствовать потребностям в производительности ее рабочих нагрузок. Чем выше риск, тем больше вероятность того, что текущая служба не может удовлетворить требованиям к производительности рабочей нагрузки.

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

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

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

Описание предпочтения режима оценки экономии, примененного для расчета возможности экономии для служб Amazon ECS.

source -> (строка)

Описание источника для расчета возможности экономии для служб Amazon ECS.

tags -> (список)

Список тегов, назначенных вашим рекомендациям по службам Amazon ECS.

(структура)

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

key -> (строка)

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

value -> (строка)

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

errors -> (список)

Массив объектов, описывающих ошибки запроса.

(структура)

Описание ошибки, возникшей при получении рекомендаций.

Например, возвращается ошибка, если вы запрашиваете рекомендации для неподдерживаемой группы Auto Scaling или если запрашиваете рекомендации для экземпляра неподдерживаемой семейства экземпляров.

identifier -> (строка)

Идентификатор ошибки.

code -> (строка)

Код ошибки.

message -> (строка)

Сообщение или причина ошибки.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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