Spec-Zone.ru › AWS CLI v2

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

Имя ведра 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 в Руководстве пользователя 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 -> (строка)

Имя хранилища 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