[ aws . compute-optimizer ]
get-rds-database-recommendations
Описание
Возвращает рекомендации Amazon RDS.
Compute Optimizer генерирует рекомендации для Amazon RDS, которые соответствуют определенному набору требований. Дополнительную информацию см. в разделе Поддерживаемые ресурсы и требования в Руководстве пользователя Compute Optimizer.
См. также: Документацию API AWS
Синтаксис
get-rds-database-recommendations
[--resource-arns <value>]
[--next-token <value>]
[--max-results <value>]
[--filters <value>]
[--account-ids <value>]
[--recommendation-preferences <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]
Параметры
--resource-arns (список)
ARN, идентифицирующий Amazon RDS.
Следующий формат ARN:
arn:aws:rds:{region}:{accountId}:db:{resourceName}Следующий формат ARN кластера БД:
arn:aws:rds:{region}:{accountId}:cluster:{resourceName}(строка)
Синтаксис:
"string" "string" ...
--next-token (строка)
--max-results (целое число)
Максимальное количество рекомендаций Amazon RDS, возвращаемых в одном запросе.
Для получения оставшихся результатов выполните другой запрос со значением, возвращённым в nextToken.
--filters (список)
Массив объектов для указания фильтра, возвращающего более конкретный список рекомендаций Amazon RDS.
(структура)
Описание фильтра, возвращающего более конкретный список рекомендаций Amazon RDS. Используйте этот фильтр с действием GetECSServiceRecommendations.
name -> (строка)
Имя фильтра.
Укажите Finding, чтобы вернуть рекомендации со специфической классификацией вывода.
Вы можете фильтровать свои рекомендации Amazon RDS по тегам tag:key и tag-key.
tag:key — это сочетание ключа и значения тега, назначенного вашим рекомендациям Amazon RDS. Используйте ключ тега в имени фильтра, а значение тега — в качестве значения фильтра. Например, чтобы найти все рекомендации Amazon RDS, имеющие тег с ключом Owner и значением TeamA, укажите tag:Owner для имени фильтра и TeamA для значения фильтра.
tag-key — это ключ тега, назначенного вашим рекомендациям Amazon RDS. Используйте этот фильтр, чтобы найти все ваши рекомендации Amazon RDS, имеющие тег с определённым ключом. Это не учитывает значение тега. Например, вы можете найти свои рекомендации Amazon RDS со значением ключа тега Owner или без каких-либо назначенных ключей тегов.
values -> (список)
Значение фильтра.
(строка)
Сокращенный синтаксис:
name=string,values=string,string ...
Синтаксис JSON:
[
{
"name": "InstanceFinding"|"InstanceFindingReasonCode"|"StorageFinding"|"StorageFindingReasonCode"|"Idle",
"values": ["string", ...]
}
...
]
--account-ids (список)
Возвращает рекомендации Amazon RDS для указанных идентификаторов аккаунтов Amazon Web Services.
Если ваш аккаунт является управляющим аккаунтом или делегированным администратором организации, используйте этот параметр, чтобы вернуть рекомендации Amazon RDS для конкретных аккаунтов-членов.
Вы можете указать только один идентификатор аккаунта в одном запросе.
(строка)
Синтаксис:
"string" "string" ...
--recommendation-preferences (структура)
Описывает предпочтения рекомендаций, которые нужно вернуть в ответе на запрос GetAutoScalingGroupRecommendations , GetEC2InstanceRecommendations , GetEC2RecommendationProjectedMetrics , GetRDSDatabaseRecommendations и GetRDSDatabaseRecommendationProjectedMetrics .
cpuVendorArchitectures -> (список)
Указывает поставщика и архитектуру процессора для рекомендаций Amazon EC2 и Auto Scaling.
Например, при указании AWS_ARM64 с:
- Запросом GetEC2InstanceRecommendations или GetAutoScalingGroupRecommendations Compute Optimizer возвращает рекомендации, состоящие только из типов экземпляров Graviton.
- Запросом GetEC2RecommendationProjectedMetrics Compute Optimizer возвращает проекционные метрики использования только для рекомендаций типа экземпляра Graviton.
- Запросом ExportEC2InstanceRecommendations или ExportAutoScalingGroupRecommendations Compute Optimizer экспортирует рекомендации, состоящие только из типов экземпляров Graviton.
(строка)
Сокращенный синтаксис:
cpuVendorArchitectures=string,string
Синтаксис JSON:
{
"cpuVendorArchitectures": ["AWS_ARM64"|"CURRENT", ...]
}
--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 (строка)
Регион для использования. Переопределяет настройки config/env.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- on
- off
- auto
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки config/env.
--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 -> (строка)
rdsDBRecommendations -> (список)
Массив объектов, описывающих рекомендации Amazon RDS.
(структура)
Описание рекомендации Amazon RDS.
resourceArn -> (строка)
ARN текущего Amazon RDS.
Следующий формат ARN:
arn:aws:rds:{region}:{accountId}:db:{resourceName}accountId -> (строка)
engine -> (строка)
engineVersion -> (строка)
promotionTier -> (целое число)
currentDBInstanceClass -> (строка)
currentStorageConfiguration -> (структура)
Конфигурация текущего хранилища RDS.
storageType -> (строка)
allocatedStorage -> (целое число)
iops -> (целое число)
maxAllocatedStorage -> (целое число)
storageThroughput -> (целое число)
dbClusterIdentifier -> (строка)
idle -> (строка)
instanceFinding -> (строка)
Классификация выявленных проблем экземпляра Amazon RDS.
Выявленные проблемы экземпляра Amazon RDS включают:
-
**
Underprovisioned** — Когда Compute Optimizer обнаруживает недостаточную конфигурацию ресурсов, Amazon RDS считается недоукомплектованным. -
**
Overprovisioned** — Когда Compute Optimizer обнаруживает избыточную конфигурацию ресурсов, Amazon RDS считается переукомплектованным. -
**
Optimized** — Когда конфигурация вашего экземпляра Amazon RDS соответствует требованиям производительности вашей рабочей нагрузки, служба считается оптимизированной.
storageFinding -> (строка)
Классификация выявленных проблем хранилища Amazon RDS.
Выявленные проблемы хранилища Amazon RDS включают:
-
**
Underprovisioned** — Когда Compute Optimizer обнаруживает недостаточное хранилище, Amazon RDS считается недоукомплектованным. -
**
Overprovisioned** — Когда Compute Optimizer обнаруживает избыточное хранилище, Amazon RDS считается переукомплектованным. -
**
Optimized** — Когда хранилище вашего Amazon RDS удовлетворяет требованиям производительности рабочей нагрузки, служба считается оптимизированной.
instanceFindingReasonCodes -> (список)
Причина классификации выявленных проблем экземпляра Amazon RDS.
(строка)
currentInstancePerformanceRisk -> (строка)
storageFindingReasonCodes -> (список)
Причина классификации выявленных проблем хранилища Amazon RDS.
(строка)
instanceRecommendationOptions -> (список)
Массив объектов, описывающих варианты рекомендаций для экземпляра Amazon RDS.
(структура)
Описание вариантов рекомендаций для экземпляра Amazon RDS.
dbInstanceClass -> (строка)
projectedUtilizationMetrics -> (список)
Массив объектов, описывающих прогнозируемые метрики использования экземпляра RDS для варианта рекомендации.
(структура)
Описание метрики использования Amazon RDS.
Чтобы определить разницу в производительности между вашим текущим Amazon RDS и рекомендуемым вариантом, сравните данные метрики использования вашей службы с прогнозируемыми данными метрики использования.
name -> (строка)
statistic -> (строка)
Статистика метрики использования.
API, командная строка (CLI) и SDK Compute Optimizer возвращают метрики использования только с помощью статистики Maximum, которая является максимальным значением, наблюдаемым в течение указанного периода.
Консоль Compute Optimizer отображает графики для некоторых метрик использования, используя статистику Average, которая представляет собой значение Sum / SampleCount в течение указанного периода. Дополнительная информация приведена в Руководстве пользователя Compute Optimizer. Вы также можете получить средние данные метрик использования для ваших ресурсов, используя Amazon CloudWatch. Дополнительная информация приведена в Руководстве пользователя Amazon CloudWatch.
value -> (двойное число)
performanceRisk -> (двойное число)
rank -> (целое число)
savingsOpportunity -> (структура)
Описание возможности экономии для рекомендаций определенного типа ресурса или для варианта рекомендации отдельного ресурса.
Возможность экономии представляет собой оценочную ежемесячную экономию, которую вы можете получить, реализовав данную рекомендацию Compute Optimizer.
Предупреждение
Для получения данных о возможности экономии необходимо включить Cost Explorer и активировать Получение рекомендаций по ресурсам Amazon EC2 на странице настроек Cost Explorer. Это создает соединение между Cost Explorer и Compute Optimizer. Благодаря этому соединению Cost Explorer генерирует оценки экономии, учитывая стоимость существующих ресурсов, стоимость рекомендуемых ресурсов и исторические данные использования. Ожидаемая ежемесячная экономия отражает прогнозируемую экономию в долларах, связанную с каждой из сгенерированных рекомендаций. Дополнительная информация приведена в Руководстве по управлению затратами, в разделах «Включение Cost Explorer» и «Оптимизация затрат с помощью рекомендаций по изменению размера».savingsOpportunityPercentage -> (двойное число)
estimatedMonthlySavings -> (структура)
Объект, описывающий оценочную ежемесячную экономию, возможную при принятии рекомендаций Compute Optimizer для данного ресурса. Основано на ценах на экземпляры On-Demand.
currency -> (строка)
value -> (двойное число)
savingsOpportunityAfterDiscounts -> (структура)
Описание возможности экономии для рекомендаций Amazon RDS или для варианта рекомендации.
Возможность экономии представляет собой оценочную ежемесячную экономию после применения скидок по Savings Plans. Вы можете добиться этого, реализовав данную рекомендацию Compute Optimizer.
savingsOpportunityPercentage -> (двойное число)
estimatedMonthlySavings -> (структура)
Ожидаемая ежемесячная экономия при принятии рекомендаций Compute Optimizer для экземпляров Amazon RDS. Включает любые применимые скидки по Savings Plans.
currency -> (строка)
value -> (двойное число)
storageRecommendationOptions -> (список)
Массив объектов, описывающих рекомендуемые варианты конфигурации хранилища Amazon RDS.
(структура)
Описание рекомендуемых вариантов конфигурации хранилища Amazon RDS.
storageConfiguration -> (структура)
Рекомендуемая конфигурация хранилища.
storageType -> (строка)
allocatedStorage -> (целое число)
iops -> (целое число)
maxAllocatedStorage -> (целое число)
storageThroughput -> (целое число)
rank -> (целое число)
savingsOpportunity -> (структура)
Описание возможности экономии для рекомендаций определенного типа ресурсов или для варианта рекомендации отдельного ресурса.
Возможность экономии представляет собой оценочную ежемесячную экономию, которую вы можете получить, реализовав данную рекомендацию Compute Optimizer.
Предупреждение
Данные о возможности экономии требуют включения Cost Explorer, а также активации параметра Получать рекомендации по ресурсам Amazon EC2 на странице настроек Cost Explorer. Это создает связь между Cost Explorer и Compute Optimizer. С этой связью Cost Explorer генерирует оценки экономии, учитывая цену существующих ресурсов, цену рекомендуемых ресурсов и исторические данные об использовании. Оценочная ежемесячная экономия отражает прогнозируемую экономию в долларах, связанную с каждой из сгенерированных рекомендаций. Более подробная информация приведена в разделе «Включение Cost Explorer и Оптимизация затрат с помощью рекомендаций по ресайзингу» в Руководстве пользователя по управлению затратами.savingsOpportunityPercentage -> (дробное число)
estimatedMonthlySavings -> (структура)
Объект, описывающий оценочную сумму ежемесячной экономии, возможную при принятии рекомендаций Compute Optimizer для данного ресурса. Основано на ценах на On-Demand экземпляры.
currency -> (строка)
value -> (дробное число)
savingsOpportunityAfterDiscounts -> (структура)
Описание возможности экономии для рекомендаций хранилища Amazon RDS или для варианта рекомендации.
Возможность экономии представляет собой оценочную ежемесячную экономию после применения скидок по планам экономии. Вы можете добиться этого, реализовав данную рекомендацию Compute Optimizer.
savingsOpportunityPercentage -> (дробное число)
estimatedMonthlySavings -> (структура)
Оценочная ежемесячная экономия, возможная при принятии рекомендаций Compute Optimizer для хранилища Amazon RDS. Включает любые применимые скидки по планам экономии.
currency -> (строка)
value -> (дробное число)
utilizationMetrics -> (список)
Массив объектов, описывающих метрики использования Amazon RDS.
(структура)
Описание метрики использования Amazon RDS.
Для определения разницы в производительности между текущим Amazon RDS и рекомендуемым вариантом сравните данные метрики использования вашего сервиса с проектными данными метрики использования.
name -> (строка)
statistic -> (строка)
Статистика метрики использования.
API, командная строка (CLI) и SDK Compute Optimizer возвращают метрики использования, используя только статистику Maximum, которая является наибольшим значением, наблюдаемым в течение указанного периода.
Консоль Compute Optimizer отображает графики для некоторых метрик использования, используя статистику Average, которая представляет собой значение Sum / SampleCount в течение указанного периода. Дополнительную информацию см. в разделе «Просмотр рекомендаций ресурсов» в Руководстве пользователя Compute Optimizer. Вы также можете получить усредненные данные метрики использования ресурсов с помощью Amazon CloudWatch. Дополнительную информацию см. в Руководстве пользователя Amazon CloudWatch.
value -> (дробное число)
effectiveRecommendationPreferences -> (структура)
Описание эффективных параметров рекомендаций для Amazon RDS.
cpuVendorArchitectures -> (список)
Описание поставщика и архитектуры процессора для рекомендаций Amazon RDS.
(строка)
enhancedInfrastructureMetrics -> (строка)
Описание состояния активации параметра расширенных метрик инфраструктуры.
Состояние Active подтверждает, что параметр применяется в последнем обновлении рекомендаций, а состояние Inactive подтверждает, что он еще не применен к рекомендациям.
Дополнительную информацию см. в разделе «Расширенные метрики инфраструктуры» в Руководстве пользователя Compute Optimizer.
lookBackPeriod -> (строка)
savingsEstimationMode -> (структура)
Описание параметров режима оценки экономии, применяемых для расчета возможности экономии для Amazon RDS.
source -> (строка)
lookbackPeriodInDays -> (дробное число)
lastRefreshTimestamp -> (временная метка)
tags -> (список)
Список тегов, присвоенных вашим рекомендациям Amazon RDS.
(структура)
Список пар ключ-значение тегов, которые вы определяете.
key -> (строка)
value -> (строка)
errors -> (список)
Массив объектов, описывающих ошибки запроса.
(структура)
Описание ошибки, возникшей при получении рекомендаций.
Например, ошибка возвращается, если вы запрашиваете рекомендации для неподдерживаемой группы Auto Scaling или если вы запрашиваете рекомендации для экземпляра неподдерживаемой семейства экземпляров.
identifier -> (строка)
code -> (строка)
message -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.