[ aws . compute-optimizer ]
export-rds-database-recommendations
Описание
Экспорт рекомендаций по оптимизации для вашей службы баз данных Amazon Relational Database Service (Amazon RDS).
Рекомендации экспортируются в файле с разделителем запятых (CSV) и его метаданными в формате JavaScript Object Notation (JSON) в существующее хранилище Amazon Simple Storage Service (Amazon S3), которое вы указываете. Дополнительную информацию см. в разделе Экспорт рекомендаций в Руководстве пользователя Compute Optimizer.
Одновременно может выполняться только одна задача экспорта Amazon RDS в каждом регионе Amazon Web Services.
См. также: Документация API AWS
Синтаксис
export-rds-database-recommendations
[--account-ids <value>]
[--filters <value>]
[--fields-to-export <value>]
--s3-destination-config <value>
[--file-format <value>]
[--include-member-accounts | --no-include-member-accounts]
[--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]
Параметры
--account-ids (список)
Идентификаторы учетных записей Amazon Web Services для экспорта рекомендаций Amazon RDS.
Если ваша учетная запись является учетной записью управления или делегированным администратором организации, используйте этот параметр для указания учетной записи участника, для которой вы хотите экспортировать рекомендации.
Этот параметр нельзя использовать вместе с параметром include member accounts. Параметры являются взаимоисключающими.
Если этот параметр или параметр include member accounts опущен, рекомендации для учетных записей участников не включаются в экспорт.
Вы можете указать несколько идентификаторов учетных записей в одном запросе.
(строка)
Синтаксис:
"string" "string" ...
--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", ...]
}
...
]
--fields-to-export (список)
Данные рекомендаций, которые следует включить в файл экспорта. Дополнительную информацию о полях, которые можно экспортировать, см. в разделе Экспортируемые файлы в Руководстве пользователя Compute Optimizer.
(строка)
Синтаксис:
"string" "string" ...
Where valid values are:
ResourceArn
AccountId
Engine
EngineVersion
Idle
MultiAZDBInstance
CurrentDBInstanceClass
CurrentStorageConfigurationStorageType
CurrentStorageConfigurationAllocatedStorage
CurrentStorageConfigurationMaxAllocatedStorage
CurrentStorageConfigurationIOPS
CurrentStorageConfigurationStorageThroughput
CurrentInstanceOnDemandHourlyPrice
CurrentStorageOnDemandMonthlyPrice
LookbackPeriodInDays
CurrentInstancePerformanceRisk
UtilizationMetricsCpuMaximum
UtilizationMetricsMemoryMaximum
UtilizationMetricsEBSVolumeStorageSpaceUtilizationMaximum
UtilizationMetricsNetworkReceiveThroughputMaximum
UtilizationMetricsNetworkTransmitThroughputMaximum
UtilizationMetricsEBSVolumeReadIOPSMaximum
UtilizationMetricsEBSVolumeWriteIOPSMaximum
UtilizationMetricsEBSVolumeReadThroughputMaximum
UtilizationMetricsEBSVolumeWriteThroughputMaximum
UtilizationMetricsDatabaseConnectionsMaximum
UtilizationMetricsStorageNetworkReceiveThroughputMaximum
UtilizationMetricsStorageNetworkTransmitThroughputMaximum
UtilizationMetricsAuroraMemoryHealthStateMaximum
UtilizationMetricsAuroraMemoryNumDeclinedSqlTotalMaximum
UtilizationMetricsAuroraMemoryNumKillConnTotalMaximum
UtilizationMetricsAuroraMemoryNumKillQueryTotalMaximum
UtilizationMetricsReadIOPSEphemeralStorageMaximum
UtilizationMetricsWriteIOPSEphemeralStorageMaximum
InstanceFinding
InstanceFindingReasonCodes
StorageFinding
StorageFindingReasonCodes
InstanceRecommendationOptionsDBInstanceClass
InstanceRecommendationOptionsRank
InstanceRecommendationOptionsPerformanceRisk
InstanceRecommendationOptionsProjectedUtilizationMetricsCpuMaximum
StorageRecommendationOptionsStorageType
StorageRecommendationOptionsAllocatedStorage
StorageRecommendationOptionsMaxAllocatedStorage
StorageRecommendationOptionsIOPS
StorageRecommendationOptionsStorageThroughput
StorageRecommendationOptionsRank
InstanceRecommendationOptionsInstanceOnDemandHourlyPrice
InstanceRecommendationOptionsSavingsOpportunityPercentage
InstanceRecommendationOptionsEstimatedMonthlySavingsCurrency
InstanceRecommendationOptionsEstimatedMonthlySavingsValue
InstanceRecommendationOptionsSavingsOpportunityAfterDiscountsPercentage
InstanceRecommendationOptionsEstimatedMonthlySavingsCurrencyAfterDiscounts
InstanceRecommendationOptionsEstimatedMonthlySavingsValueAfterDiscounts
StorageRecommendationOptionsOnDemandMonthlyPrice
StorageRecommendationOptionsSavingsOpportunityPercentage
StorageRecommendationOptionsEstimatedMonthlySavingsCurrency
StorageRecommendationOptionsEstimatedMonthlySavingsValue
StorageRecommendationOptionsSavingsOpportunityAfterDiscountsPercentage
StorageRecommendationOptionsEstimatedMonthlySavingsCurrencyAfterDiscounts
StorageRecommendationOptionsEstimatedMonthlySavingsValueAfterDiscounts
EffectiveRecommendationPreferencesCpuVendorArchitectures
EffectiveRecommendationPreferencesEnhancedInfrastructureMetrics
EffectiveRecommendationPreferencesLookBackPeriod
EffectiveRecommendationPreferencesSavingsEstimationMode
LastRefreshTimestamp
Tags
DBClusterIdentifier
PromotionTier
--s3-destination-config (структура)
Описание имени хранилища Amazon Simple Storage Service (Amazon S3) и префикса ключа для задачи экспорта рекомендаций.
Вы должны создать целевое хранилище Amazon S3 для экспорта рекомендаций перед созданием задачи экспорта. Compute Optimizer не создаёт хранилище S3 за вас. После создания хранилища S3 убедитесь, что оно имеет необходимую политику разрешений, позволяющую Compute Optimizer записывать в него файл экспорта. Если вы планируете указать префикс объекта при создании задачи экспорта, вы должны включить префикс объекта в политику, которую вы добавляете в хранилище S3. Дополнительную информацию см. в разделе Политика хранилища Amazon S3 для Compute Optimizer в Руководстве пользователя Compute Optimizer.
bucket -> (строка)
keyPrefix -> (строка)
Сокращенный синтаксис:
bucket=string,keyPrefix=string
Синтаксис JSON:
{
"bucket": "string",
"keyPrefix": "string"
}
--file-format (строка)
Формат файла экспорта.
В настоящее время поддерживается только формат CSV.
Возможные значения:
Csv
--include-member-accounts | --no-include-member-accounts (булево)
Если ваша учетная запись является учетной записью управления или делегированным администратором организации, этот параметр указывает, следует ли включать рекомендации для ресурсов во всех учетных записях участников организации.
Учетные записи участников также должны быть подключены к Compute Optimizer, и доступ с доверием для Compute Optimizer должен быть включен в учетной записи организации. Дополнительную информацию см. в разделе Compute Optimizer и Amazon Web Services Organizations trusted access в Руководстве пользователя Compute Optimizer.
Если этот параметр опущен, рекомендации для учетных записей участников организации не включаются в файл экспорта.
Если этот параметр или параметр идентификатора учетной записи опущен, рекомендации для учетных записей участников не включаются в экспорт.
--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 (строка)
Используемый регион. Переопределяет настройки конфигурации/среды.
--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.
Вывод
jobId -> (строка)
Идентификационный номер задачи экспорта.
Для просмотра состояния задачи экспорта используйте действие DescribeRecommendationExportJobs и укажите идентификатор задачи.
s3Destination -> (структура)
Описывает имя назначения Amazon Simple Storage Service (Amazon S3) корзины и ключи объектов файла экспорта рекомендаций и связанного с ним файла метаданных.
bucket -> (строка)
key -> (строка)
Ключ корзины Amazon S3 файла экспорта.
Ключ однозначно идентифицирует объект или файл экспорта в корзине S3.
metadataKey -> (строка)
Ключ корзины Amazon S3 файла метаданных.
Ключ однозначно идентифицирует объект или файл метаданных в корзине S3.
© Copyright 2025, Amazon Web Services. Created using Sphinx.