[ aws . compute-optimizer ]
экспорт рекомендаций для групп автоматического масштабирования
Описание
Экспортирует рекомендации по оптимизации для групп автоматического масштабирования.
Рекомендации экспортируются в файл с разделителями (CSV) и его метаданные в файле JavaScript Object Notation (JSON) в существующий пакет Amazon Simple Storage Service (Amazon S3), который вы указываете. Дополнительную информацию см. в разделе Экспорт рекомендаций в руководстве пользователя Compute Optimizer.
Вы можете иметь только одну задачу экспорта группы автоматического масштабирования в процессе в одном регионе Amazon Web Services.
См. также: Документацию API AWS
Синтаксис
export-auto-scaling-group-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, для которых требуется экспорт рекомендаций по группам Auto Scaling.
Если ваша учетная запись является учетной записью управления организацией, используйте этот параметр для указания учетной записи участника, для которой вы хотите экспортировать рекомендации.
Этот параметр нельзя указывать вместе с параметром включения учетных записей участников. Параметры взаимоисключающие.
Рекомендации для учетных записей участников не включаются в экспорт, если этот параметр или параметр включения учетных записей участников опущен.
Вы можете указать несколько идентификаторов учетных записей в одном запросе.
(строка)
Синтаксис:
"string" "string" ...
--filters (список)
Массив объектов для указания фильтра, который экспортирует более конкретный набор рекомендаций по группам Auto Scaling.
(структура)
Описывает фильтр, который возвращает более конкретный список рекомендаций. Используйте этот фильтр с действиями 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— Конфигурация памяти виртуальной машины не соответствует требованиям к производительности вашей рабочей нагрузки, и существует альтернативный тип виртуальной машины, обеспечивающий лучшую производительность памяти. -
**
EBSThroughputOverprovisioned— Конфигурацию пропускной способности EBS виртуальной машины можно уменьшить, сохраняя при этом требования к производительности вашей рабочей нагрузки. -
**
EBSThroughputUnderprovisioned— Конфигурация пропускной способности EBS виртуальной машины не соответствует требованиям к производительности вашей рабочей нагрузки, и существует альтернативный тип виртуальной машины, обеспечивающий лучшую производительность пропускной способности EBS. - … (и так далее)
-
**
(строка)
Сокращенный синтаксис:
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
AutoScalingGroupArn
AutoScalingGroupName
Finding
UtilizationMetricsCpuMaximum
UtilizationMetricsMemoryMaximum
UtilizationMetricsEbsReadOpsPerSecondMaximum
UtilizationMetricsEbsWriteOpsPerSecondMaximum
UtilizationMetricsEbsReadBytesPerSecondMaximum
UtilizationMetricsEbsWriteBytesPerSecondMaximum
UtilizationMetricsDiskReadOpsPerSecondMaximum
UtilizationMetricsDiskWriteOpsPerSecondMaximum
UtilizationMetricsDiskReadBytesPerSecondMaximum
UtilizationMetricsDiskWriteBytesPerSecondMaximum
UtilizationMetricsNetworkInBytesPerSecondMaximum
UtilizationMetricsNetworkOutBytesPerSecondMaximum
UtilizationMetricsNetworkPacketsInPerSecondMaximum
UtilizationMetricsNetworkPacketsOutPerSecondMaximum
LookbackPeriodInDays
CurrentConfigurationInstanceType
CurrentConfigurationDesiredCapacity
CurrentConfigurationMinSize
CurrentConfigurationMaxSize
CurrentConfigurationAllocationStrategy
CurrentConfigurationMixedInstanceTypes
CurrentConfigurationType
CurrentOnDemandPrice
CurrentStandardOneYearNoUpfrontReservedPrice
CurrentStandardThreeYearNoUpfrontReservedPrice
CurrentVCpus
CurrentMemory
CurrentStorage
CurrentNetwork
RecommendationOptionsConfigurationInstanceType
RecommendationOptionsConfigurationDesiredCapacity
RecommendationOptionsConfigurationMinSize
RecommendationOptionsConfigurationMaxSize
RecommendationOptionsConfigurationEstimatedInstanceHourReductionPercentage
RecommendationOptionsConfigurationAllocationStrategy
RecommendationOptionsConfigurationMixedInstanceTypes
RecommendationOptionsConfigurationType
RecommendationOptionsProjectedUtilizationMetricsCpuMaximum
RecommendationOptionsProjectedUtilizationMetricsMemoryMaximum
RecommendationOptionsPerformanceRisk
RecommendationOptionsOnDemandPrice
RecommendationOptionsStandardOneYearNoUpfrontReservedPrice
RecommendationOptionsStandardThreeYearNoUpfrontReservedPrice
RecommendationOptionsVcpus
RecommendationOptionsMemory
RecommendationOptionsStorage
RecommendationOptionsNetwork
LastRefreshTimestamp
CurrentPerformanceRisk
RecommendationOptionsSavingsOpportunityPercentage
RecommendationOptionsEstimatedMonthlySavingsCurrency
RecommendationOptionsEstimatedMonthlySavingsValue
EffectiveRecommendationPreferencesCpuVendorArchitectures
EffectiveRecommendationPreferencesEnhancedInfrastructureMetrics
EffectiveRecommendationPreferencesInferredWorkloadTypes
EffectiveRecommendationPreferencesPreferredResources
EffectiveRecommendationPreferencesLookBackPeriod
InferredWorkloadTypes
RecommendationOptionsMigrationEffort
CurrentInstanceGpuInfo
RecommendationOptionsInstanceGpuInfo
UtilizationMetricsGpuPercentageMaximum
UtilizationMetricsGpuMemoryPercentageMaximum
RecommendationOptionsProjectedUtilizationMetricsGpuPercentageMaximum
RecommendationOptionsProjectedUtilizationMetricsGpuMemoryPercentageMaximum
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 (структура)
Объект для указания предпочтений для экспорта рекомендаций группы автоматического масштабирования.
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 для вывода.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запросить параметры ввода CLI.
Вывод
jobId -> (строка)
Идентификационный номер задачи экспорта.
Используйте действие DescribeRecommendationExportJobs и укажите идентификатор задачи, чтобы просмотреть состояние задачи экспорта.
s3Destination -> (структура)
Объект, описывающий целевое хранилище Amazon S3 для файла экспорта рекомендаций.
bucket -> (строка)
key -> (строка)
Ключ хранилища Amazon S3 для файла экспорта.
Ключ однозначно идентифицирует объект или файл экспорта в хранилище S3.
metadataKey -> (строка)
Ключ хранилища Amazon S3 для файла метаданных.
Ключ однозначно идентифицирует объект или файл метаданных в хранилище S3.
© Copyright 2025, Amazon Web Services. Created using Sphinx.