[ aws . compute-optimizer ]
get-ebs-volume-recommendations
Описание
Возвращает рекомендации по объёмам Amazon Elastic Block Store (Amazon EBS).
Compute Optimizer генерирует рекомендации по объёмам Amazon EBS, которые соответствуют определённому набору требований. Дополнительную информацию см. в разделе Поддерживаемые ресурсы и требования в руководстве пользователя Compute Optimizer.
См. также: Документацию API AWS
Синтаксис
get-ebs-volume-recommendations
[--volume-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]
Параметры
--volume-arns (список)
Amazon Resource Name (ARN) объёмов, для которых требуется получить рекомендации.
(строка)
Синтаксис:
"string" "string" ...
--next-token (строка)
--max-results (целое число)
Максимальное количество рекомендаций по объёмам, возвращаемых в одном запросе.
Для получения оставшихся результатов выполните ещё один запрос с возвращенным значением nextToken.
--filters (список)
Массив объектов для указания фильтра, который возвращает более конкретный список рекомендаций по объёмам.
(структура)
Описание фильтра, который возвращает более конкретный список рекомендаций по объёмам Amazon Elastic Block Store (Amazon EBS). Используйте этот фильтр с действием GetEBSVolumeRecommendations.
Вы можете использовать LambdaFunctionRecommendationFilter с действием GetLambdaFunctionRecommendations, JobFilter с действием DescribeRecommendationExportJobs и Filter с действиями GetAutoScalingGroupRecommendations и GetEC2InstanceRecommendations.
name -> (строка)
Имя фильтра.
Укажите Finding, чтобы вернуть рекомендации с конкретной классификацией результатов (например, NotOptimized).
Вы можете фильтровать рекомендации по объёмам Amazon EBS по тегам tag:key и tag-key.
tag:key — это комбинация ключа и значения тега, назначенного вашим рекомендациям по объёмам Amazon EBS. Используйте ключ тега в имени фильтра, а значение тега — в качестве значения фильтра. Например, чтобы найти все рекомендации по объёмам Amazon EBS, имеющие тег с ключом Owner и значением TeamA, укажите tag:Owner для имени фильтра и TeamA для значения фильтра.
tag-key — это ключ тега, назначенного вашим рекомендациям по объёмам Amazon EBS. Используйте этот фильтр, чтобы найти все ваши рекомендации по объёмам Amazon EBS, имеющие тег с определённым ключом. Это не учитывает значение тега. Например, вы можете найти свои рекомендации по объёмам Amazon EBS с ключом тега Owner или без каких-либо назначенных ключей тегов.
values -> (список)
Значение фильтра.
Допустимые значения — Optimized или NotOptimized.
(строка)
Сокращённый синтаксис:
name=string,values=string,string ...
Синтаксис JSON:
[
{
"name": "Finding",
"values": ["string", ...]
}
...
]
--account-ids (список)
Идентификатор учётной записи Amazon Web Services, для которой требуется вернуть рекомендации по объёмам.
Если ваша учётная запись является учётной записью управления организацией, используйте этот параметр для указания учётной записи участника, для которой вы хотите получить рекомендации по объёмам.
В одном запросе можно указать только один идентификатор учётной записи.
(строка)
Синтаксис:
"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 -> (строка)
Токен, используемый для перехода к следующей странице рекомендаций по объёмам.
Это значение равно null, когда больше нет страниц рекомендаций по объёмам для возврата.
volumeRecommendations -> (список)
Массив объектов, описывающих рекомендации по объёмам.
(структура)
Описывает рекомендацию по объёму Amazon Elastic Block Store (Amazon EBS).
volumeArn -> (строка)
accountId -> (строка)
currentConfiguration -> (структура)
Массив объектов, описывающих текущую конфигурацию объёма.
volumeType -> (строка)
Тип объёма.
Типы объёмов могут быть следующими:
- SSD общего назначения
gp2иgp3 - SSD с заданной производительностью ввода/вывода
io1,io2иio2 Block Express - HDD с оптимизированной пропускной способностью
st1 - HDD для холодного хранения
sc1 - Магнитные объёмы
standard
volumeSize -> (целое число)
volumeBaselineIOPS -> (целое число)
volumeBurstIOPS -> (целое число)
volumeBaselineThroughput -> (целое число)
volumeBurstThroughput -> (целое число)
rootVolume -> (логическое значение)
finding -> (строка)
Классификация результата для объёма.
Результаты для объёмов включают:
-
**
NotOptimized** —Объём считается неоптимизированным, когда Compute Optimizer определяет рекомендацию, которая может обеспечить лучшую производительность для вашей рабочей нагрузки. -
**
Optimized** —Объём считается оптимизированным, когда Compute Optimizer определяет, что объём правильно настроен для работы вашей рабочей нагрузки на основе выбранного типа объёма. Для оптимизированных ресурсов Compute Optimizer может порекомендовать новый тип объёма.
utilizationMetrics -> (список)
Массив объектов, описывающих метрики использования объёма.
(структура)
Описание метрики использования объёма Amazon Elastic Block Store (Amazon EBS).
Сравните данные метрики использования вашего ресурса с прогнозируемыми данными метрики использования, чтобы определить разницу в производительности между вашим текущим ресурсом и рекомендуемым вариантом.
name -> (строка)
Имя метрики использования.
Доступны следующие метрики использования:
-
VolumeReadOpsPerSecond- Количество завершенных операций чтения с объёма в заданный период времени. Единица измерения: Кол-во -
VolumeWriteOpsPerSecond- Количество завершенных операций записи на объём в заданный период времени. Единица измерения: Кол-во -
VolumeReadBytesPerSecond- Количество байтов, прочитанных с объёма в заданный период времени. Единица измерения: Байты -
VolumeWriteBytesPerSecond- Количество байтов, записанных на объём в заданный период времени. Единица измерения: Байты
statistic -> (строка)
Статистика метрики использования.
API, командная строка (CLI) и SDK Compute Optimizer возвращают метрики использования только с использованием статистики Maximum, которая является наибольшим значением, наблюдаемым в течение заданного периода.
Консоль Compute Optimizer отображает графики для некоторых метрик использования, используя статистику Average, которая является значением Sum / SampleCount в течение заданного периода. Дополнительные сведения см. в руководстве пользователя Compute Optimizer.
value -> (двойное число)
lookBackPeriodInDays -> (двойное число)
volumeRecommendationOptions -> (список)
Массив объектов, описывающих варианты рекомендаций по объёму.
(структура)
Описание варианта рекомендации для экземпляра Amazon Elastic Block Store (Amazon EBS).
configuration -> (структура)
Массив объектов, описывающих конфигурацию объёма.
volumeType -> (строка)
Тип объёма.
Типы объёмов могут быть следующими:
- SSD общего назначения
gp2иgp3 - SSD с заданной производительностью ввода/вывода
io1,io2иio2 Block Express - HDD с оптимизированной пропускной способностью
st1 - HDD для холодного хранения
sc1 - Магнитные объёмы
standard
volumeSize -> (целое число)
volumeBaselineIOPS -> (целое число)
volumeBurstIOPS -> (целое число)
volumeBaselineThroughput -> (целое число)
volumeBurstThroughput -> (целое число)
rootVolume -> (логическое значение)
performanceRisk -> (двойное число)
Риск производительности варианта рекомендации по объёму.
Риск производительности — это вероятность того, что рекомендованный тип объёма удовлетворит требованиям производительности вашей рабочей нагрузки.
Значение изменяется от 0 до 4, причём 0 означает, что рекомендованный ресурс, по прогнозам, всегда будет иметь достаточную аппаратную мощность. Чем выше риск производительности, тем более вероятно, что вам следует проверить, соответствует ли рекомендация требованиям производительности вашей рабочей нагрузки, прежде чем мигрировать ваш ресурс.
rank -> (целое число)
Рейтинг варианта рекомендации по объёму.
Вариант с наивысшим рейтингом имеет рейтинг 1.
savingsOpportunity -> (структура)
Объект, описывающий возможность экономии для варианта рекомендации по объёму EBS. Возможность экономии включает в себя прогнозируемый ежемесячный объем экономии и процент.
savingsOpportunityPercentage -> (двойное число)
estimatedMonthlySavings -> (структура)
Объект, описывающий прогнозируемый ежемесячный объем экономии при принятии рекомендаций Compute Optimizer для данного ресурса. Это основано на ценах на экземпляры "по запросу".
currency -> (строка)
value -> (двойное число)
savingsOpportunityAfterDiscounts -> (структура)
Объект, описывающий возможность экономии для варианта рекомендации по объёму Amazon EBS с конкретными скидками. Возможность экономии включает в себя прогнозируемый ежемесячный объем экономии и процент.
savingsOpportunityPercentage -> (двойное число)
estimatedMonthlySavings -> (структура)
Прогнозируемая ежемесячная экономия в процентах от ежемесячных затрат при принятии рекомендаций Compute Optimizer по объёмам Amazon EBS. Экономия включает в себя все применимые скидки.
currency -> (строка)
value -> (двойное число)
lastRefreshTimestamp -> (временная метка)
currentPerformanceRisk -> (строка)
effectiveRecommendationPreferences -> (структура)
Описание эффективных настроек рекомендаций для объёма Amazon EBS.
savingsEstimationMode -> (структура)
Описание режима оценки экономии, применяемого для расчета возможности экономии для объёмов Amazon EBS.
source -> (строка)
tags -> (список)
Список тегов, назначенных вашим рекомендациям по объёмам Amazon EBS.
(структура)
Список пар ключ-значение тегов, которые вы определяете.
key -> (строка)
value -> (строка)
errors -> (список)
Массив объектов, описывающих ошибки запроса.
Например, ошибка возвращается, если вы запрашиваете рекомендации для неподдерживаемого объёма.
(структура)
Описывает ошибку, возникшую при получении рекомендаций.
Например, ошибка возвращается, если вы запрашиваете рекомендации для неподдерживаемой группы Auto Scaling или для экземпляра неподдерживаемой семейства экземпляров.
identifier -> (строка)
code -> (строка)
message -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.