Spec-Zone.ru › AWS CLI v2

[ aws . compute-optimizer ]

get-idle-recommendations

Описание

Возвращает рекомендации по ресурсам, неиспользуемым в данный момент. Compute Optimizer генерирует рекомендации для неиспользуемых ресурсов, которые соответствуют определенному набору требований. Дополнительную информацию см. в разделе «Требования к ресурсам» в руководстве пользователя Compute Optimizer.

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

Синтаксис

  get-idle-recommendations
[--resource-arns <value>]
[--next-token <value>]
[--max-results <value>]
[--filters <value>]
[--account-ids <value>]
[--order-by <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, идентифицирующий неиспользуемый ресурс.

(строка)

Синтаксис:

"string" "string" ...

--next-token (строка)

Токен для перехода к следующей странице рекомендаций по неиспользуемым ресурсам.

--max-results (целое число)

Максимальное количество рекомендаций по неиспользуемым ресурсам, возвращаемых за один запрос.

Для получения оставшихся результатов выполните еще один запрос с возвращенным значением nextToken.

--filters (список)

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

(структура)

Описание фильтра, возвращающего более конкретный список рекомендаций по неиспользуемым ресурсам.

name -> (строка)

Имя фильтра.

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

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

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

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

values -> (список)

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

(строка)

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

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

Синтаксис JSON:

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

--account-ids (список)

Возвращение рекомендаций по неиспользуемым ресурсам для указанных идентификаторов учетных записей Amazon Web Services.

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

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

(строка)

Синтаксис:

"string" "string" ...

--order-by (структура)

Порядок сортировки рекомендаций по неиспользуемым ресурсам.

dimension -> (строка)

Значения измерений для сортировки рекомендаций.

order -> (строка)

Порядок сортировки рекомендаций.

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

dimension=string,order=string

Синтаксис JSON:

{
  "dimension": "SavingsValue"|"SavingsValueAfterDiscount",
  "order": "Asc"|"Desc"
}

--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
  • таблица
  • 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 версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок, 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 -> (строка)

Токен для перехода к следующей странице рекомендаций по неактивным ресурсам.

idleRecommendations -> (список)

Массив объектов, описывающих рекомендации по неактивным ресурсам.

(структура)

Описание рекомендации по неактивному ресурсу.

resourceArn -> (строка)

ARN текущего неактивного ресурса.

resourceId -> (строка)

Уникальный идентификатор ресурса.

resourceType -> (строка)

Тип ресурса, который неактивен.

accountId -> (строка)

Идентификатор учетной записи Amazon Web Services неактивного ресурса.

finding -> (строка)

Классификация результата для неактивного ресурса.

findingDescription -> (строка)

Краткое описание результатов для ресурса.

savingsOpportunity -> (структура)

Возможность экономии для неактивного ресурса.

savingsOpportunityPercentage -> (двойное)

Ожидаемая ежемесячная экономия в процентах от ежемесячных затрат путем принятия рекомендаций Compute Optimizer по неактивным ресурсам.

estimatedMonthlySavings -> (структура)

Ожидаемая ежемесячная экономия, которую можно получить, приняв рекомендации Compute Optimizer по неактивным ресурсам.

currency -> (строка)

Валюта ожидаемой ежемесячной экономии.

value -> (двойное)

Значение ожидаемой ежемесячной экономии для неактивных ресурсов.

savingsOpportunityAfterDiscounts -> (структура)

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

savingsOpportunityPercentage -> (двойное)

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

estimatedMonthlySavings -> (структура)

Ожидаемая ежемесячная экономия, которую можно получить, приняв рекомендации Compute Optimizer по неактивным ресурсам. Включает все применимые скидки.

currency -> (строка)

Валюта ожидаемой ежемесячной экономии.

value -> (двойное)

Значение ожидаемой ежемесячной экономии для неактивных ресурсов.

utilizationMetrics -> (список)

Массив объектов, описывающих метрики использования неактивного ресурса.

(структура)

Описание метрики использования неактивного ресурса.

name -> (строка)

Имя метрики использования.

statistic -> (строка)

Статистика метрики использования.

API Compute Optimizer, командная строка (CLI) и SDK возвращают метрики использования, используя только статистику Maximum, которая является наибольшим значением, наблюдаемым в течение указанного периода.

Консоль Compute Optimizer отображает графики для некоторых метрик использования, используя статистику Average, которая является значением Sum / SampleCount в течение указанного периода. Дополнительную информацию см. в руководстве пользователя Compute Optimizer. Также можно получить усредненные данные метрик использования ресурсов с помощью Amazon CloudWatch. Дополнительную информацию см. в руководстве пользователя Amazon CloudWatch.

value -> (двойное)

Значение метрики использования.

lookBackPeriodInDays -> (двойное)

Количество дней, в течение которых анализировались метрики использования неактивного ресурса.

lastRefreshTimestamp -> (метка времени)

Метка времени последнего создания рекомендации по неактивному ресурсу.

tags -> (список)

Список тегов, назначенных вашим рекомендациям по неактивным ресурсам.

(структура)

Список пар ключ-значение тегов, определенных вами.

key -> (строка)

Одна часть пары ключ-значение, составляющей тег. Ключ — это общее обозначение, которое выполняет роль категории для более конкретных значений тегов.

value -> (строка)

Одна часть пары ключ-значение, составляющей тег. Значение выступает в качестве описателя в категории тегов (ключ). Значение может быть пустым или нулевым.

errors -> (список)

Массив объектов, описывающих ошибки запроса.

(структура)

Возвращает список ресурсов, для которых нет рекомендаций по неактивным ресурсам.

identifier -> (строка)

Идентификатор ошибки.

code -> (строка)

Код ошибки.

message -> (строка)

Сообщение об ошибке.

resourceType -> (строка)

Тип ресурса, связанного с ошибкой.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API