[ aws . compute-optimizer ]
экспорт-рекомендаций-виртуальных-машин-ec2
Описание
Экспортирует рекомендации по оптимизации для виртуальных машин Amazon EC2.
Рекомендации экспортируются в файле с разделителями в виде запятых (.csv) и его метаданные в формате JavaScript Object Notation (JSON) (.json) в существующий ведро Amazon Simple Storage Service (Amazon S3), которое вы указываете. Для получения дополнительной информации см. раздел Экспорт рекомендаций в Руководстве пользователя Compute Optimizer.
Вы можете иметь только одну задачу экспорта виртуальных машин Amazon EC2, которая выполняется в каждом регионе Amazon Web Services.
См. также: Документация API AWS
Синтаксис
export-ec2-instance-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, для которых необходимо экспортировать рекомендации по экземплярам.
Если ваша учётная запись является управляющей учётной записью организации, используйте этот параметр для указания учётной записи участника, для которой вы хотите экспортировать рекомендации.
Этот параметр нельзя указать вместе с параметром include member accounts. Параметры взаимоисключающие.
Рекомендации для учётных записей участников не включаются в экспорт, если этот параметр или параметр include member accounts опущен.
Вы можете указать несколько идентификаторов учётных записей в одном запросе.
(строка)
Синтаксис:
"string" "string" ...
--filters (список)
Массив объектов для указания фильтра, который экспортирует более узкий набор рекомендаций по экземплярам.
(структура)
Описывает фильтр, который возвращает более узкий список рекомендаций. Используйте этот фильтр с действиями GetAutoScalingGroupRecommendations и GetEC2InstanceRecommendations.
Вы можете использовать EBSFilter с действием GetEBSVolumeRecommendations, LambdaFunctionRecommendationFilter с действием GetLambdaFunctionRecommendations и JobFilter с действием DescribeRecommendationExportJobs.
name -> (строка)
Имя фильтра.
Укажите Finding, чтобы вернуть рекомендации с определённой классификацией результата. Например, Underprovisioned.
Укажите RecommendationSourceType, чтобы вернуть рекомендации определённого типа ресурса. Например, Ec2Instance.
Укажите FindingReasonCodes, чтобы вернуть рекомендации с определённым кодом причины результата. Например, CPUUnderprovisioned.
Укажите InferredWorkloadTypes, чтобы вернуть рекомендации с определённой выявленной рабочей нагрузкой. Например, Redis.
Вы можете фильтровать рекомендации по экземплярам EC2 по тегам tag:key и tag-key.
tag:key — это комбинация ключа и значения тега, назначенного вашим рекомендациям. Используйте ключ тега в имени фильтра, а значение тега — в качестве значения фильтра. Например, чтобы найти все рекомендации, имеющие тег с ключом Owner и значением TeamA, укажите tag:Owner для имени фильтра и TeamA для значения фильтра.
tag-key — это ключ тега, назначенного вашим рекомендациям. Используйте этот фильтр, чтобы найти все рекомендации, которые имеют тег с определённым ключом. Это не учитывает значение тега. Например, вы можете найти свои рекомендации с ключом тега Owner или без каких-либо назначенных ключей тегов.
values -> (список)
Значение фильтра.
Допустимые значения для этого параметра приведены ниже в зависимости от того, что вы указали для параметра name и типа ресурса, для которого вы хотите отфильтровать результаты:
- Укажите
OptimizedилиNotOptimized, если вы указали параметрnameкакFindingи хотите отфильтровать результаты для групп Auto Scaling. - Укажите
Underprovisioned,OverprovisionedилиOptimized, если вы указали параметрnameкакFindingи хотите отфильтровать результаты для экземпляров EC2. - Укажите
Ec2InstanceилиAutoScalingGroup, если вы указали параметрnameкакRecommendationSourceType. - Укажите один из следующих вариантов, если вы указали параметр
nameкакFindingReasonCodes:-
**
CPUOverprovisioned— Конфигурация процессора экземпляра может быть уменьшена, сохраняя при этом требования к производительности вашей рабочей нагрузки. -
**
CPUUnderprovisioned— Конфигурация процессора экземпляра не соответствует требованиям к производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, обеспечивающий лучшую производительность процессора. -
**
MemoryOverprovisioned— Конфигурация памяти экземпляра может быть уменьшена, сохраняя при этом требования к производительности вашей рабочей нагрузки. -
**
MemoryUnderprovisioned— Конфигурация памяти экземпляра не соответствует требованиям к производительности вашей рабочей нагрузки, и существует альтернативный тип экземпляра, обеспечивающий лучшую производительность памяти. - И т.д.
-
**
(строка)
Упрощённый синтаксис:
name=string,values=string,string ...
Синтаксис JSON:
[
{
"name": "Finding"|"FindingReasonCodes"|"RecommendationSourceType"|"InferredWorkloadTypes",
"values": ["string", ...]
}
...
]
--fields-to-export (список)
Данные рекомендаций, которые необходимо включить в файл экспорта. Дополнительную информацию о полях, которые можно экспортировать, см. в разделе Экспортируемые файлы в Руководстве пользователя Compute Optimizer.
(строка)
Синтаксис:
"string" "string" ...
Where valid values are:
AccountId
InstanceArn
InstanceName
Finding
FindingReasonCodes
LookbackPeriodInDays
CurrentInstanceType
UtilizationMetricsCpuMaximum
UtilizationMetricsMemoryMaximum
UtilizationMetricsEbsReadOpsPerSecondMaximum
UtilizationMetricsEbsWriteOpsPerSecondMaximum
UtilizationMetricsEbsReadBytesPerSecondMaximum
UtilizationMetricsEbsWriteBytesPerSecondMaximum
UtilizationMetricsDiskReadOpsPerSecondMaximum
UtilizationMetricsDiskWriteOpsPerSecondMaximum
UtilizationMetricsDiskReadBytesPerSecondMaximum
UtilizationMetricsDiskWriteBytesPerSecondMaximum
UtilizationMetricsNetworkInBytesPerSecondMaximum
UtilizationMetricsNetworkOutBytesPerSecondMaximum
UtilizationMetricsNetworkPacketsInPerSecondMaximum
UtilizationMetricsNetworkPacketsOutPerSecondMaximum
CurrentOnDemandPrice
CurrentStandardOneYearNoUpfrontReservedPrice
CurrentStandardThreeYearNoUpfrontReservedPrice
CurrentVCpus
CurrentMemory
CurrentStorage
CurrentNetwork
RecommendationOptionsInstanceType
RecommendationOptionsProjectedUtilizationMetricsCpuMaximum
RecommendationOptionsProjectedUtilizationMetricsMemoryMaximum
RecommendationOptionsPlatformDifferences
RecommendationOptionsPerformanceRisk
RecommendationOptionsVcpus
RecommendationOptionsMemory
RecommendationOptionsStorage
RecommendationOptionsNetwork
RecommendationOptionsOnDemandPrice
RecommendationOptionsStandardOneYearNoUpfrontReservedPrice
RecommendationOptionsStandardThreeYearNoUpfrontReservedPrice
RecommendationsSourcesRecommendationSourceArn
RecommendationsSourcesRecommendationSourceType
LastRefreshTimestamp
CurrentPerformanceRisk
RecommendationOptionsSavingsOpportunityPercentage
RecommendationOptionsEstimatedMonthlySavingsCurrency
RecommendationOptionsEstimatedMonthlySavingsValue
EffectiveRecommendationPreferencesCpuVendorArchitectures
EffectiveRecommendationPreferencesEnhancedInfrastructureMetrics
EffectiveRecommendationPreferencesInferredWorkloadTypes
InferredWorkloadTypes
RecommendationOptionsMigrationEffort
EffectiveRecommendationPreferencesExternalMetricsSource
Tags
InstanceState
ExternalMetricStatusCode
ExternalMetricStatusReason
CurrentInstanceGpuInfo
RecommendationOptionsInstanceGpuInfo
UtilizationMetricsGpuPercentageMaximum
UtilizationMetricsGpuMemoryPercentageMaximum
RecommendationOptionsProjectedUtilizationMetricsGpuPercentageMaximum
RecommendationOptionsProjectedUtilizationMetricsGpuMemoryPercentageMaximum
Idle
EffectiveRecommendationPreferencesPreferredResources
EffectiveRecommendationPreferencesLookBackPeriod
EffectiveRecommendationPreferencesUtilizationPreferences
EffectiveRecommendationPreferencesSavingsEstimationMode
RecommendationOptionsSavingsOpportunityAfterDiscountsPercentage
RecommendationOptionsEstimatedMonthlySavingsCurrencyAfterDiscounts
RecommendationOptionsEstimatedMonthlySavingsValueAfterDiscounts
--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 в Руководстве пользователя Compute Optimizer.
Рекомендации для учётных записей участников организации не включаются в файл экспорта, если этот параметр опущен.
Рекомендации для учётных записей участников не включаются в экспорт, если этот параметр или параметр идентификаторов учётных записей опущен.
--recommendation-preferences (структура)
Объект для указания предпочтений для экспорта рекомендаций по экземплярам Amazon EC2.
cpuVendorArchitectures -> (список)
Указывает производителя и архитектуру процессора для рекомендаций по экземплярам Amazon EC2 и группам автоматического масштабирования.
Например, при указании 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
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для использования в фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/отключить вывод цвета.
- включено
- выключено
- авто
--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-auto-prompt (логическое значение)
Автоматически запрашивать параметры входных данных CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запроса параметров входных данных CLI.
Вывод
jobId -> (строка)
Идентификационный номер задачи экспорта.
Используйте действие DescribeRecommendationExportJobs, указав ID задачи, чтобы просмотреть состояние задачи экспорта.
s3Destination -> (структура)
Объект, описывающий целевой Amazon S3-ведро файла экспорта рекомендаций.
bucket -> (строка)
key -> (строка)
Ключ Amazon S3-ведёр файла экспорта.
Ключ однозначно идентифицирует объект или файл экспорта в ведре S3.
metadataKey -> (строка)
Ключ Amazon S3-ведёр файла метаданных.
Ключ однозначно идентифицирует объект или файл метаданных в ведре S3.
© Copyright 2025, Amazon Web Services. Created using Sphinx.