Spec-Zone.ru › AWS CLI v2

[ aws . compute-optimizer ]

рекомендации-экспорта-томов-ebs

Описание

Экспортирует рекомендации по оптимизации для томов Amazon EBS.

Рекомендации экспортируются в файл с разделителем запятых (.csv) и его метаданные в файле JavaScript Object Notation (JSON) (.json) в указанный вами существующий бакет Amazon Simple Storage Service (Amazon S3). Для получения дополнительной информации см. Экспорт рекомендаций в руководстве пользователя Compute Optimizer.

Вы можете иметь только одну задачу экспорта томов Amazon EBS в процессе в каждой Amazon Web Services Регионе.

См. также: Документация AWS API

Синтаксис

  export-ebs-volume-recommendations
[--account-ids <value>]
[--filters <value>]
[--fields-to-export <value>]
--s3-destination-config <value>
[--file-format <value>]
[--include-member-accounts | --no-include-member-accounts]
[--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 EBS.

Если ваш аккаунт является управляющим аккаунтом организации, используйте этот параметр для указания аккаунта члена, для которого вы хотите экспортировать рекомендации.

Этот параметр не может быть указан вместе с параметром включения аккаунтов членов. Параметры взаимоисключающие.

Рекомендации для аккаунтов членов не включаются в экспорт, если этот параметр или параметр включения аккаунтов членов опущен.

Вы можете указать несколько идентификаторов аккаунтов в одном запросе.

(строка)

Синтаксис:

"string" "string" ...

--filters (список)

Массив объектов для указания фильтра, который экспортирует более конкретный набор рекомендаций по томам Amazon EBS.

(структура)

Описание фильтра, возвращающего более конкретный список рекомендаций по томам Amazon Elastic Block Store (Amazon EBS). Используйте этот фильтр с действием GetEBSVolumeRecommendations.

Вы можете использовать LambdaFunctionRecommendationFilter с действием GetLambdaFunctionRecommendations, JobFilter с действием DescribeRecommendationExportJobs и Filter с действиями GetAutoScalingGroupRecommendations и GetEC2InstanceRecommendations.

name -> (строка)

Имя фильтра.

Укажите Finding, чтобы вернуть рекомендации с определённой классификацией обнаружения (например, NotOptimized).

Вы можете фильтровать свои рекомендации по томам Amazon EBS по тегам tag:key и tag-key.

tag:key — это комбинация ключа и значения тега, назначенного вашим рекомендациям по томам Amazon EBS. Используйте ключ тега в имени фильтра, а значение тега — в качестве значения фильтра. Например, чтобы найти все рекомендации по томам Amazon EBS, имеющие тег с ключом Owner и значением TeamA, укажите tag:Owner для имени фильтра и TeamA для значения фильтра.

tag-key — это ключ тега, назначенного вашим рекомендациям по томам Amazon EBS. Используйте этот фильтр, чтобы найти все ваши рекомендации по томам Amazon EBS, которые имеют тег с определённым ключом. Это не учитывает значение тега. Например, вы можете найти свои рекомендации по томам Amazon EBS с ключом тега Owner или без каких-либо назначенных ключей тегов.

values -> (список)

Значение фильтра.

Допустимые значения — Optimized или NotOptimized.

(строка)

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

name=string,values=string,string ...

Синтаксис JSON:

[
  {
    "name": "Finding",
    "values": ["string", ...]
  }
  ...
]

--fields-to-export (список)

Данные рекомендаций, которые нужно включить в файл экспорта. Для получения дополнительной информации о полях, которые можно экспортировать, см. Экспортируемые файлы в руководстве пользователя Compute Optimizer.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  AccountId
  VolumeArn
  Finding
  UtilizationMetricsVolumeReadOpsPerSecondMaximum
  UtilizationMetricsVolumeWriteOpsPerSecondMaximum
  UtilizationMetricsVolumeReadBytesPerSecondMaximum
  UtilizationMetricsVolumeWriteBytesPerSecondMaximum
  LookbackPeriodInDays
  CurrentConfigurationVolumeType
  CurrentConfigurationVolumeBaselineIOPS
  CurrentConfigurationVolumeBaselineThroughput
  CurrentConfigurationVolumeBurstIOPS
  CurrentConfigurationVolumeBurstThroughput
  CurrentConfigurationVolumeSize
  CurrentMonthlyPrice
  RecommendationOptionsConfigurationVolumeType
  RecommendationOptionsConfigurationVolumeBaselineIOPS
  RecommendationOptionsConfigurationVolumeBaselineThroughput
  RecommendationOptionsConfigurationVolumeBurstIOPS
  RecommendationOptionsConfigurationVolumeBurstThroughput
  RecommendationOptionsConfigurationVolumeSize
  RecommendationOptionsMonthlyPrice
  RecommendationOptionsPerformanceRisk
  LastRefreshTimestamp
  CurrentPerformanceRisk
  RecommendationOptionsSavingsOpportunityPercentage
  RecommendationOptionsEstimatedMonthlySavingsCurrency
  RecommendationOptionsEstimatedMonthlySavingsValue
  Tags
  RootVolume
  CurrentConfigurationRootVolume
  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.

Рекомендации для аккаунтов-членов организации не включаются в файл экспорта, если этот параметр опущен.

Этот параметр не может быть указан вместе с параметром идентификаторов аккаунтов. Параметры взаимоисключающие.

Рекомендации для аккаунтов-членов не включаются в экспорт, если этот параметр или параметр идентификаторов аккаунтов опущен.

--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 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