Spec-Zone.ru › AWS CLI v2

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

Имя ведра 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 (структура)

Объект для указания предпочтений для экспорта рекомендаций по экземплярам 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 -> (строка)

Имя 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