Spec-Zone.ru › AWS CLI v2

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

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

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

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

rdsDBRecommendations -> (список)

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

(структура)

Описание рекомендации Amazon RDS.

resourceArn -> (строка)

ARN текущего Amazon RDS.

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

arn:aws:rds:{region}:{accountId}:db:{resourceName}

accountId -> (строка)

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

engine -> (строка)

Двигатель экземпляра RDS.

engineVersion -> (строка)

Версия базы данных.

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

Уровень повышения для экземпляра Aurora.

currentDBInstanceClass -> (строка)

Класс экземпляра базы данных текущего экземпляра RDS.

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

Конфигурация текущего хранилища RDS.

storageType -> (строка)

Тип хранилища RDS.

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

Размер хранилища RDS в гигабайтах (ГБ).

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

Зарезервированные IOPS хранилища RDS.

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

Максимальный лимит в гибибайтах (GiB), до которого Amazon RDS может автоматически масштабировать хранилище экземпляра RDS.

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

Производительность хранилища RDS.

dbClusterIdentifier -> (строка)

Идентификатор кластера БД.

idle -> (строка)

Указывает, является ли экземпляр RDS неактивным.

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

Описание рекомендации по классу экземпляра базы данных для вашего экземпляра Amazon RDS.

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

Риск производительности варианта рекомендации экземпляра RDS.

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

Идентификатор ранга варианта рекомендации экземпляра RDS.

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

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

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

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

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

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

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

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

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

currency -> (строка)

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

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

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

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

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

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

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

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

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

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

currency -> (строка)

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

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

Значение оценочной ежемесячной экономии для экземпляров Amazon RDS.

storageRecommendationOptions -> (список)

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

(структура)

Описание рекомендуемых вариантов конфигурации хранилища Amazon RDS.

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

Рекомендуемая конфигурация хранилища.

storageType -> (строка)

Тип хранилища RDS.

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

Размер хранилища RDS в гигабайтах (ГБ).

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

Зарезервированные IOPS хранилища RDS.

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

Максимальный предел в гигабайтах (GiB), до которого Amazon RDS может автоматически масштабировать хранилище экземпляра RDS.

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

Пропускная способность хранилища RDS.

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

Идентификатор ранга рекомендуемого варианта конфигурации хранилища RDS.

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

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

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

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

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

savingsOpportunityPercentage -> (дробное число)

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

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

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

currency -> (строка)

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

value -> (дробное число)

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

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

Описание возможности экономии для рекомендаций хранилища Amazon RDS или для варианта рекомендации.

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

savingsOpportunityPercentage -> (дробное число)

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

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

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

currency -> (строка)

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

value -> (дробное число)

Значение оценочной ежемесячной экономии для хранилища Amazon RDS.

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

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

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

Описание параметров режима оценки экономии, применяемых для расчета возможности экономии для Amazon RDS.

source -> (строка)

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

lookbackPeriodInDays -> (дробное число)

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

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

Временная метка последнего обновления рекомендации Amazon RDS.

tags -> (список)

Список тегов, присвоенных вашим рекомендациям Amazon RDS.

(структура)

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

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