Spec-Zone.ru › AWS CLI v2

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

Имя хранилища Amazon S3, которое используется в качестве назначения для задачи экспорта.

keyPrefix -> (строка)

Префикс хранилища Amazon S3 для задачи экспорта.

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

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

Имя корзины Amazon S3, используемой в качестве назначения файла экспорта.

key -> (строка)

Ключ корзины Amazon S3 файла экспорта.

Ключ однозначно идентифицирует объект или файл экспорта в корзине S3.

metadataKey -> (строка)

Ключ корзины Amazon S3 файла метаданных.

Ключ однозначно идентифицирует объект или файл метаданных в корзине S3.

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

Spec-Zone.ru

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