[ aws . compute-optimizer ]
get-license-recommendations
Описание
Возвращает рекомендации по лицензиям для экземпляров Amazon EC2, работающих под конкретной лицензией.
Compute Optimizer генерирует рекомендации по лицензиям, которые соответствуют определенному набору требований. Дополнительную информацию см. в разделе «Поддерживаемые ресурсы и требования» в руководстве пользователя Compute Optimizer.
См. также: Документацию API AWS
Синтаксис
get-license-recommendations
[--resource-arns <value>]
[--next-token <value>]
[--max-results <value>]
[--filters <value>]
[--account-ids <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]
Параметры
--resource-arns (список)
ARN, идентифицирующий экземпляр Amazon EC2.
Следующий формат ARN:
arn:aws:ec2:region:aws_account_id:instance/instance-id(строка)
Синтаксис:
"string" "string" ...
--next-token (строка)
--max-results (целое число)
Максимальное количество рекомендаций по лицензиям, возвращаемых в одном запросе.
Для получения оставшихся результатов отправьте еще один запрос со значением, возвращенным в nextToken.
--filters (список)
Массив объектов для указания фильтра, который возвращает более конкретный список рекомендаций по лицензиям.
(структура)
Описывает фильтр, который возвращает более конкретный список рекомендаций по лицензиям. Используйте этот фильтр с действием GetLicenseRecommendation.
name -> (строка)
Имя фильтра.
Укажите Finding, чтобы вернуть рекомендации с определенной классификацией выявления.
Укажите FindingReasonCode, чтобы вернуть рекомендации с определенным кодом причины выявления.
Вы можете отфильтровать рекомендации по лицензиям по меткам tag:key и tag-key.
tag:key — это комбинация ключа и значения метки, назначенной вашим рекомендациям по лицензиям. Используйте ключ метки в имени фильтра, а значение метки — в качестве значения фильтра. Например, чтобы найти все рекомендации по лицензиям, имеющие метку с ключом Owner и значением TeamA, укажите tag:Owner для имени фильтра и TeamA для значения фильтра.
tag-key — это ключ метки, назначенной вашим рекомендациям по лицензиям. Используйте этот фильтр, чтобы найти все ваши рекомендации по лицензиям, имеющие метку с определенным ключом. При этом значение метки не учитывается. Например, вы можете найти свои рекомендации по лицензиям с ключом метки Owner или без назначенных ключей меток.
values -> (список)
Значение фильтра.
Допустимые значения для этого параметра зависят от того, что вы указали для параметра name:
- Если вы указали параметр
nameкакFinding, укажитеOptimized,NotOptimizedилиInsufficentMetrics. - Если вы указали параметр
nameкакFindingReasonCode, укажитеOptimized,LicenseOverprovisioned,InvalidCloudwatchApplicationInsightsилиCloudwatchApplicationInsightsError.
(строка)
Сокращенный синтаксис:
name=string,values=string,string ...
Синтаксис JSON:
[
{
"name": "Finding"|"FindingReasonCode"|"LicenseName",
"values": ["string", ...]
}
...
]
--account-ids (список)
ID учетной записи Amazon Web Services, для которой необходимо вернуть рекомендации по лицензиям.
Если ваша учетная запись является учетной записью управления организацией, используйте этот параметр для указания учетной записи участника, для которой вы хотите получить рекомендации по лицензиям.
В одном запросе можно указать только один идентификатор учетной записи.
(строка)
Синтаксис:
"string" "string" ...
--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.
Вывод
nextToken -> (строка)
licenseRecommendations -> (список)
Массив объектов, описывающих рекомендации по лицензиям.
(структура)
Описание рекомендации по лицензии для экземпляра EC2.
resourceArn -> (строка)
accountId -> (строка)
currentLicenseConfiguration -> (структура)
Объект, описывающий текущую конфигурацию экземпляра, работающего под лицензией.
numberOfCores -> (целое число)
instanceType -> (строка)
operatingSystem -> (строка)
licenseEdition -> (строка)
licenseName -> (строка)
licenseModel -> (строка)
licenseVersion -> (строка)
metricsSource -> (список)
Список источников метрик, необходимых для генерации рекомендаций по коммерческим лицензиям программного обеспечения.
(структура)
Список источников метрик, необходимых для генерации рекомендаций по коммерческим лицензиям программного обеспечения.
provider -> (строка)
providerArn -> (строка)
lookbackPeriodInDays -> (вещественное число)
lastRefreshTimestamp -> (временная метка)
finding -> (строка)
Классификация результата для экземпляра, работающего под лицензией.
Результаты включают:
-
InsufficentMetrics— Когда Compute Optimizer обнаруживает, что CloudWatch Application Insights не включен или включен с недостаточными правами. -
NotOptimized— Когда Compute Optimizer обнаруживает, что ваша инфраструктура EC2 не использует ни одну из функций лицензии SQL Server, за которые вы платите, лицензия считается не оптимизированной. -
Optimized— Когда Compute Optimizer обнаруживает, что все параметры вашей лицензии соответствуют требованиям производительности вашей рабочей нагрузки.
findingReasonCodes -> (список)
Причина классификации результата для экземпляра, работающего под лицензией.
Причины результатов включают:
-
Optimized— Все параметры вашей лицензии соответствуют требованиям производительности вашей рабочей нагрузки. -
LicenseOverprovisioned— Лицензия считается избыточно обеспеченной, если ее можно понизить, сохранив при этом соответствие требованиям производительности рабочей нагрузки. -
InvalidCloudwatchApplicationInsights— CloudWatch Application Insights не настроен должным образом. -
CloudwatchApplicationInsightsError— Возникла ошибка CloudWatch Application Insights.
(строка)
licenseRecommendationOptions -> (список)
Массив объектов, описывающих варианты рекомендаций по лицензиям.
(структура)
Описание вариантов рекомендаций по лицензиям.
rank -> (целое число)
Ранг варианта рекомендации по лицензии.
Лучший вариант рекомендации имеет ранг 1 .
operatingSystem -> (строка)
licenseEdition -> (строка)
licenseModel -> (строка)
savingsOpportunity -> (структура)
Описание возможности экономии для рекомендаций определенного типа ресурса или для варианта рекомендации отдельного ресурса.
Возможность экономии представляет собой оценочную ежемесячную экономию, которую можно получить, реализовав определенную рекомендацию Compute Optimizer.
Предупреждение
Данные о возможности экономии требуют включения в Cost Explorer, а также активации опции Получать рекомендации по ресурсам Amazon EC2 на странице настроек Cost Explorer. Это создает соединение между Cost Explorer и Compute Optimizer. С этим соединением Cost Explorer генерирует оценки экономии, учитывая стоимость существующих ресурсов, стоимость рекомендуемых ресурсов и исторические данные использования. Ожидаемая ежемесячная экономия отражает прогнозируемую экономию в долларах, связанную с каждой из сгенерированных рекомендаций. Для получения дополнительной информации см. Раздел «Включение Cost Explorer и Оптимизация затрат с помощью рекомендаций по масштабированию» в Руководстве пользователя Cost Management.savingsOpportunityPercentage -> (вещественное число)
estimatedMonthlySavings -> (структура)
Объект, описывающий оценочную сумму ежемесячной экономии, возможной при принятии рекомендаций Compute Optimizer для данного ресурса. Это основано на ценах на экземпляры On-Demand.
currency -> (строка)
value -> (вещественное число)
tags -> (список)
Список тегов, назначенных экземпляру EC2.
(структура)
Список пар ключ-значение тегов, которые вы определяете.
key -> (строка)
value -> (строка)
errors -> (список)
Массив объектов, описывающих ошибки запроса.
(структура)
Описание ошибки, возникшей при получении рекомендаций.
Например, ошибка возвращается, если вы запрашиваете рекомендации для недопустимой группы Auto Scaling или для экземпляра недопустимой семейства экземпляров.
identifier -> (строка)
code -> (строка)
message -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.