[ aws . compute-optimizer ]
Экспорт рекомендаций для сервисов Amazon ECS на Fargate
Описание
Экспортирует рекомендации по оптимизации для сервисов Amazon ECS на Fargate.
Рекомендации экспортируются в файл CSV, а метаданные — в файл JSON, в существующий бакет Amazon Simple Storage Service (Amazon S3), который вы указываете. Дополнительную информацию см. в разделе Экспорт рекомендаций в Руководстве пользователя Compute Optimizer.
Вы можете иметь только одну задачу экспорта сервиса Amazon ECS, выполняемую в одном регионе Amazon Web Services.
См. также: Документация API AWS
Синтаксис
export-ecs-service-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 ECS.
Если ваша учетная запись является учетной записью управления или делегированным администратором организации, используйте этот параметр для указания учетной записи члена, для которой необходимо экспортировать рекомендации.
Этот параметр не может быть указан вместе с параметром include member accounts. Параметры исключают друг друга.
Если этот параметр или параметр include member accounts опущен, рекомендации для учетных записей членов не включаются в экспорт.
Вы можете указать несколько идентификаторов учетных записей в одном запросе.
(строка)
Синтаксис:
"string" "string" ...
--filters (список)
Массив объектов для указания фильтра, который экспортирует более узкий набор рекомендаций для сервисов Amazon ECS.
(структура)
Описание фильтра, который возвращает более узкий список рекомендаций для сервисов Amazon ECS. Используйте этот фильтр с действием GetECSServiceRecommendations.
name -> (строка)
Имя фильтра.
Укажите Finding, чтобы получить рекомендации со специфической классификацией выявления.
Укажите FindingReasonCode, чтобы получить рекомендации со специфическим кодом причины выявления.
Вы можете фильтровать рекомендации для сервисов Amazon ECS по tag:key и tag-key тегам.
tag:key — это сочетание ключа и значения тега, назначенного вашим рекомендациям для сервисов Amazon ECS. Используйте ключ тега в имени фильтра, а значение тега — в качестве значения фильтра. Например, чтобы найти все рекомендации для сервисов Amazon ECS, имеющие тег с ключом Owner и значением TeamA, укажите tag:Owner для имени фильтра и TeamA для значения фильтра.
tag-key — это ключ тега, назначенного вашим рекомендациям для сервисов Amazon ECS. Используйте этот фильтр, чтобы найти все ваши рекомендации для сервисов Amazon ECS, которые имеют тег со специфическим ключом. Это не учитывает значение тега. Например, вы можете найти свои рекомендации для сервисов Amazon ECS с ключом тега Owner или без каких-либо назначенных ключей тегов.
values -> (список)
Значение фильтра.
Допустимые значения для этого параметра:
- Если вы указали параметр
nameкакFinding, укажитеOptimized,UnderprovisionedилиOverprovisioned. - Если вы указали параметр
nameкакFindingReasonCode, укажитеCPUUnderprovisioned,CPUOverprovisioned,MemoryUnderprovisionedилиMemoryOverprovisioned.
(строка)
Сокращенный синтаксис:
name=string,values=string,string ...
Синтаксис JSON:
[
{
"name": "Finding"|"FindingReasonCode",
"values": ["string", ...]
}
...
]
--fields-to-export (список)
Данные рекомендаций, которые необходимо включить в файл экспорта. Дополнительную информацию о полях, которые можно экспортировать, см. в разделе Экспортируемые файлы в Руководстве пользователя Compute Optimizer.
(строка)
Синтаксис:
"string" "string" ...
Where valid values are:
AccountId
ServiceArn
LookbackPeriodInDays
LastRefreshTimestamp
LaunchType
CurrentPerformanceRisk
CurrentServiceConfigurationMemory
CurrentServiceConfigurationCpu
CurrentServiceConfigurationTaskDefinitionArn
CurrentServiceConfigurationAutoScalingConfiguration
CurrentServiceContainerConfigurations
UtilizationMetricsCpuMaximum
UtilizationMetricsMemoryMaximum
Finding
FindingReasonCodes
RecommendationOptionsMemory
RecommendationOptionsCpu
RecommendationOptionsSavingsOpportunityPercentage
RecommendationOptionsEstimatedMonthlySavingsCurrency
RecommendationOptionsEstimatedMonthlySavingsValue
RecommendationOptionsContainerRecommendations
RecommendationOptionsProjectedUtilizationMetricsCpuMaximum
RecommendationOptionsProjectedUtilizationMetricsMemoryMaximum
Tags
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.
Если этот параметр опущен, рекомендации для учетных записей членов организации не включаются в файл экспорта.
Если этот параметр или параметр account ID опущен, рекомендации для учетных записей членов не включаются в экспорт.
--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
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определенный профиль из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/отключить цветной вывод.
- on
- off
- auto
--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 -> (строка)
key -> (строка)
Ключ бакета Amazon S3 файла экспорта.
Ключ однозначно идентифицирует объект, или файл экспорта, в бакете S3.
metadataKey -> (строка)
Ключ бакета Amazon S3 файла метаданных.
Ключ однозначно идентифицирует объект, или файл метаданных, в бакете S3.
© Copyright 2025, Amazon Web Services. Created using Sphinx.