получение-рекомендаций-по-оптимизации-размера

Описание

Создаёт рекомендации, которые помогут сэкономить средства, выявляя простаивающие и недоиспользуемые экземпляры Amazon EC2.

Рекомендации генерируются для уменьшения размера или завершения работы экземпляров, а также предоставления подробной информации о сэкономленных средствах и показателях. Более подробную информацию о расчёте и функциях см. в руководстве пользователя «Оптимизация затрат с помощью рекомендаций по оптимизации размера» в руководстве пользователя по управлению расходами и счетами.

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

Синопсис

  get-rightsizing-recommendation
[--filter <value>]
[--configuration <value>]
--service <value>
[--page-size <value>]
[--next-page-token <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]

Параметры

--filter (структура)

Используйте Expression для фильтрации в различных API Cost Explorer.

Не все типы Expression поддерживаются в каждом API. Обратитесь к документации для каждого конкретного API, чтобы узнать, что поддерживается.

Существует два шаблона:

Простые значения измерений.
- Существуют три типа простых значений измерений: CostCategories , Tags и Dimensions .
  - Укажите поле CostCategories, чтобы определить фильтр, действующий на категории затрат.
  - Укажите поле Tags, чтобы определить фильтр, действующий на теги распределения затрат.
  - Укажите поле Dimensions, чтобы определить фильтр, действующий на ` DimensionValues https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html`__.
- Для каждого типа фильтра вы можете указать имя измерения и значения для фильтров, которые вы планируете использовать.
  - Например, вы можете отфильтровать REGION==us-east-1 OR REGION==us-west-1. Для GetRightsizingRecommendation регион указывается полным именем (например, REGION==US East (N. Virginia)).
  - Соответствующее Expression для этого примера приведено ниже: { "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] } }
  - Как показано в предыдущем примере, списки значений измерений комбинируются с OR при применении фильтра.
- Вы также можете установить различные параметры соответствия для дополнительного управления поведением фильтра. Не все API поддерживают параметры соответствия. Обратитесь к документации для каждого конкретного API, чтобы узнать, что поддерживается.
  - Например, вы можете отфильтровать имена связанных учётных записей, начинающиеся с "a".
  - Соответствующее Expression для этого примера приведено ниже: { "Dimensions": { "Key": "LINKED_ACCOUNT_NAME", "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] } }
Составные типы Expression с логическими операциями.
- Вы можете использовать несколько типов Expression и логические операторы AND/OR/NOT для создания списка одного или нескольких объектов Expression. Таким образом, вы можете фильтровать по более сложным параметрам.
- Например, вы можете фильтровать по ((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer).
- Соответствующее Expression для этого примера приведено ниже: { "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] }

Примечание

Поскольку каждый Expression может иметь только один оператор, служба возвращает ошибку, если указано более одного. Следующий пример показывает объект Expression, который вызывает ошибку: { "And": [ ... ], "Dimensions": { "Key": "USAGE_TYPE", "Values": [ "DataTransfer" ] } }

Следующее — пример соответствующего сообщения об ошибке: "Expression has more than one roots. Only one root operator is allowed for each expression: And, Or, Not, Dimensions, Tags, CostCategories"

Примечание

Для действия GetRightsizingRecommendation комбинация OR и NOT не поддерживается. OR не поддерживается между разными измерениями или измерениями и тегами. Операторы NOT не поддерживаются. Измерения также ограничены LINKED_ACCOUNT , REGION или RIGHTSIZING_TYPE.

Для действия GetReservationPurchaseRecommendation поддерживается только NOT. AND и OR не поддерживаются. Измерения ограничены LINKED_ACCOUNT.

Или -> (список)

Возвращает результаты, соответствующие любому из объектов Dimension.

(структура)

Используйте Expression для фильтрации в различных API Cost Explorer.

Существует два шаблона:

Простые значения измерений.
- Существуют три типа простых значений измерений: CostCategories , Tags и Dimensions .
  - Укажите поле CostCategories, чтобы определить фильтр, действующий на категории затрат.
  - Укажите поле Tags, чтобы определить фильтр, действующий на теги распределения затрат.
  - Укажите поле Dimensions, чтобы определить фильтр, действующий на ` DimensionValues https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html`__.
- Для каждого типа фильтра вы можете указать имя измерения и значения для фильтров, которые вы планируете использовать.
  - Например, вы можете отфильтровать REGION==us-east-1 OR REGION==us-west-1. Для GetRightsizingRecommendation регион указывается полным именем (например, REGION==US East (N. Virginia)).
  - Соответствующее Expression для этого примера приведено ниже: { "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] } }
  - Как показано в предыдущем примере, списки значений измерений комбинируются с OR при применении фильтра.
- Вы также можете установить различные параметры соответствия для дополнительного управления поведением фильтра. Не все API поддерживают параметры соответствия. Обратитесь к документации для каждого конкретного API, чтобы узнать, что поддерживается.
  - Например, вы можете отфильтровать имена связанных учётных записей, начинающиеся с "a".
  - Соответствующее Expression для этого примера приведено ниже: { "Dimensions": { "Key": "LINKED_ACCOUNT_NAME", "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] } }
Составные типы Expression с логическими операциями.
- Вы можете использовать несколько типов Expression и логические операторы AND/OR/NOT для создания списка одного или нескольких объектов Expression. Таким образом, вы можете фильтровать по более сложным параметрам.
- Например, вы можете фильтровать по ((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer).
- Соответствующее Expression для этого примера приведено ниже: { "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] }

Примечание

Или -> (список)

Возвращает результаты, соответствующие любому из объектов Dimension.

(... рекурсивно ...)

И -> (список)

Возвращает результаты, соответствующие обоим объектам Dimension.

(... рекурсивно ...)

Измерения -> (структура)

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

Ключ -> (строка)

Названия типов метаданных, которые можно использовать для фильтрации и группировки результатов. Например, AZ возвращает список доступных зон.

Не все измерения поддерживаются в каждом API. Обратитесь к документации для каждого конкретного API, чтобы узнать, что поддерживается.

LINKED_ACCOUNT_NAME и SERVICE_CODE могут использоваться только в CostCategoryRule.

ANOMALY_TOTAL_IMPACT_ABSOLUTE и ANOMALY_TOTAL_IMPACT_PERCENTAGE могут использоваться только в AnomalySubscriptions.

Значения -> (список)

Значения метаданных, которые можно использовать для фильтрации и группировки результатов. Вы можете использовать GetDimensionValues для поиска определённых значений.

(строка)

MatchOptions -> (список)

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

MatchOptions применимо только к действиям, связанным с категориями затрат и подписками на аномалии. Обратитесь к документации для каждого конкретного API, чтобы узнать, что поддерживается.

Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Теги -> (структура)

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

Ключ -> (строка)

Ключ тега.

Значения -> (список)

Конкретное значение тега.

(строка)

MatchOptions -> (список)

Параметры соответствия, которые можно использовать для фильтрации результатов. MatchOptions применимо только к действиям, связанным с категориями затрат. Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

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

Фильтр, основанный на значениях CostCategory.

Ключ -> (строка)

Уникальное имя категории затрат.

Значения -> (список)

Конкретное значение категории затрат.

(строка)

MatchOptions -> (список)

Параметры соответствия, которые можно использовать для фильтрации результатов. MatchOptions применимо только к действиям, связанным с категориями затрат. Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

И -> (список)

Возвращать результаты, которые соответствуют обоим объектам Dimension.

(структура)

Используйте Expression для фильтрации в различных API Cost Explorer.

Существует два шаблона:

Простые значения измерений.
- Существуют три типа простых значений измерений: CostCategories , Tags и Dimensions .
  - Укажите поле CostCategories, чтобы определить фильтр, который действует на категории затрат.
  - Укажите поле Tags, чтобы определить фильтр, который действует на теги распределения затрат.
  - Укажите поле Dimensions, чтобы определить фильтр, который действует на ` DimensionValues https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_DimensionValues.html`__.
- Для каждого типа фильтра вы можете задать имя измерения и значения для фильтров, которые вы планируете использовать.
  - Например, вы можете отфильтровать по REGION==us-east-1 OR REGION==us-west-1. Для GetRightsizingRecommendation регион — это полное название (например, REGION==US East (N. Virginia)).
  - Соответствующее значение Expression для этого примера приведено ниже: { "Dimensions": { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] } }
  - Как показано в предыдущем примере, списки значений измерений объединяются с OR при применении фильтра.
- Вы также можете задать различные параметры сопоставления, чтобы дополнительно контролировать поведение фильтра. Не все API поддерживают параметры сопоставления. Обратитесь к документации для каждого конкретного API, чтобы узнать, что поддерживается.
  - Например, вы можете отфильтровать по именам связанных учетных записей, начинающимся с «a».
  - Соответствующее значение Expression для этого примера приведено ниже: { "Dimensions": { "Key": "LINKED_ACCOUNT_NAME", "MatchOptions": [ "STARTS_WITH" ], "Values": [ "a" ] } }
Составные типы Expression с логическими операциями.
- Вы можете использовать несколько типов Expression и логические операторы AND/OR/NOT, чтобы создать список одного или нескольких объектов Expression. Таким образом, вы можете отфильтровать по более сложным параметрам.
- Например, вы можете отфильтровать по ((REGION == us-east-1 OR REGION == us-west-1) OR (TAG.Type == Type1)) AND (USAGE_TYPE != DataTransfer).
- Соответствующее значение Expression для этого примера приведено ниже: { "And": [ {"Or": [ {"Dimensions": { "Key": "REGION", "Values": [ "us-east-1", "us-west-1" ] }}, {"Tags": { "Key": "TagName", "Values": ["Value1"] } } ]}, {"Not": {"Dimensions": { "Key": "USAGE_TYPE", "Values": ["DataTransfer"] }}} ] }

Примечание

Поскольку каждый Expression может иметь только один оператор, служба возвращает ошибку, если указано более одного. Следующий пример показывает объект Expression, который создаёт ошибку: { "And": [ ... ], "Dimensions": { "Key": "USAGE_TYPE", "Values": [ "DataTransfer" ] } }

Примечание

Для действия GetRightsizingRecommendation комбинация OR и NOT не поддерживается. OR не поддерживается между различными измерениями или измерениями и тегами. Операторы NOT не поддерживаются. Измерения также ограничены LINKED_ACCOUNT , REGION или RIGHTSIZING_TYPE.

Или -> (список)

Возвращать результаты, которые соответствуют любому из объектов Dimension.

(… рекурсивно …)

И -> (список)

Возвращать результаты, которые соответствуют обоим объектам Dimension.

(… рекурсивно …)

(… рекурсивно …)Измерения -> (структура)

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

Ключ -> (строка)

LINKED_ACCOUNT_NAME и SERVICE_CODE могут использоваться только в CostCategoryRule.

ANOMALY_TOTAL_IMPACT_ABSOLUTE и ANOMALY_TOTAL_IMPACT_PERCENTAGE могут использоваться только в AnomalySubscriptions.

Значения -> (список)

(строка)

Параметры сопоставления -> (список)

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

MatchOptions применим только к действиям, связанным с категориями затрат и подписками на оповещения о несоответствиях. Обратитесь к документации для каждого конкретного API, чтобы узнать, что поддерживается.

Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Теги -> (структура)

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

Ключ -> (строка)

Ключ тега.

Значения -> (список)

Конкретное значение тега.

(строка)

Параметры сопоставления -> (список)

Параметры сопоставления, которые можно использовать для фильтрации результатов. MatchOptions применим только к действиям, связанным с категориями затрат. Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Категории затрат -> (структура)

Фильтр, основанный на значениях CostCategory.

Ключ -> (строка)

Уникальное имя категории затрат.

Значения -> (список)

Конкретное значение категории затрат.

(строка)

Параметры сопоставления -> (список)

Параметры сопоставления, которые можно использовать для фильтрации результатов. Параметр MatchOptions применим только к действиям, связанным с категорией затрат. Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Не -> (структура)

Возвращать результаты, которые не соответствуют объекту Dimension.

Или -> (список)

Возвращать результаты, которые соответствуют любому из объектов Dimension.

(… рекурсивно …)

И -> (список)

Возвращать результаты, которые соответствуют обоим объектам Dimension.

(… рекурсивно …)

(… рекурсивно …)Измерения -> (структура)

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

Ключ -> (строка)

LINKED_ACCOUNT_NAME и SERVICE_CODE могут использоваться только в CostCategoryRule.

ANOMALY_TOTAL_IMPACT_ABSOLUTE и ANOMALY_TOTAL_IMPACT_PERCENTAGE могут использоваться только в AnomalySubscriptions.

Значения -> (список)

(строка)

Параметры сопоставления -> (список)

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

Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Теги -> (структура)

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

Ключ -> (строка)

Ключ тега.

Значения -> (список)

Конкретное значение тега.

(строка)

Параметры сопоставления -> (список)

(строка)

Категории затрат -> (структура)

Фильтр, основанный на значениях CostCategory.

Ключ -> (строка)

Уникальное имя категории затрат.

Значения -> (список)

Конкретное значение категории затрат.

(строка)

Параметры сопоставления -> (список)

(строка)

Измерения -> (структура)

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

Ключ -> (строка)

LINKED_ACCOUNT_NAME и SERVICE_CODE могут использоваться только в CostCategoryRule.

ANOMALY_TOTAL_IMPACT_ABSOLUTE и ANOMALY_TOTAL_IMPACT_PERCENTAGE могут использоваться только в AnomalySubscriptions.

Значения -> (список)

(строка)

Параметры сопоставления -> (список)

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

Значения по умолчанию для MatchOptions — EQUALS и CASE_SENSITIVE.

(строка)

Теги -> (структура)

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

Ключ -> (строка)

Ключ тега.

Значения -> (список)

Конкретное значение тега.

(строка)

Параметры сопоставления -> (список)

(строка)

Категории затрат -> (структура)

Фильтр, основанный на значениях CostCategory.

Ключ -> (строка)

Уникальное имя категории затрат.

Значения -> (список)

Конкретное значение категории затрат.

(строка)

Параметры сопоставления -> (список)

(строка)

Синтаксис JSON:

{
  "Or": [
    {
      "Or": [
        { ... recursive ... }
        ...
      ],
      "And": [
        { ... recursive ... }
        ...
      ],
      "Not": { ... recursive ... },
      "Dimensions": {
        "Key": "AZ"|"INSTANCE_TYPE"|"LINKED_ACCOUNT"|"LINKED_ACCOUNT_NAME"|"OPERATION"|"PURCHASE_TYPE"|"REGION"|"SERVICE"|"SERVICE_CODE"|"USAGE_TYPE"|"USAGE_TYPE_GROUP"|"RECORD_TYPE"|"OPERATING_SYSTEM"|"TENANCY"|"SCOPE"|"PLATFORM"|"SUBSCRIPTION_ID"|"LEGAL_ENTITY_NAME"|"DEPLOYMENT_OPTION"|"DATABASE_ENGINE"|"CACHE_ENGINE"|"INSTANCE_TYPE_FAMILY"|"BILLING_ENTITY"|"RESERVATION_ID"|"RESOURCE_ID"|"RIGHTSIZING_TYPE"|"SAVINGS_PLANS_TYPE"|"SAVINGS_PLAN_ARN"|"PAYMENT_OPTION"|"AGREEMENT_END_DATE_TIME_AFTER"|"AGREEMENT_END_DATE_TIME_BEFORE"|"INVOICING_ENTITY"|"ANOMALY_TOTAL_IMPACT_ABSOLUTE"|"ANOMALY_TOTAL_IMPACT_PERCENTAGE",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
      },
      "Tags": {
        "Key": "string",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
      },
      "CostCategories": {
        "Key": "string",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
      }
    }
    ...
  ],
  "And": [
    {
      "Or": [
        { ... recursive ... }
        ...
      ],
      "And": [
        { ... recursive ... }
        ...
      ],
      "Not": { ... recursive ... },
      "Dimensions": {
        "Key": "AZ"|"INSTANCE_TYPE"|"LINKED_ACCOUNT"|"LINKED_ACCOUNT_NAME"|"OPERATION"|"PURCHASE_TYPE"|"REGION"|"SERVICE"|"SERVICE_CODE"|"USAGE_TYPE"|"USAGE_TYPE_GROUP"|"RECORD_TYPE"|"OPERATING_SYSTEM"|"TENANCY"|"SCOPE"|"PLATFORM"|"SUBSCRIPTION_ID"|"LEGAL_ENTITY_NAME"|"DEPLOYMENT_OPTION"|"DATABASE_ENGINE"|"CACHE_ENGINE"|"INSTANCE_TYPE_FAMILY"|"BILLING_ENTITY"|"RESERVATION_ID"|"RESOURCE_ID"|"RIGHTSIZING_TYPE"|"SAVINGS_PLANS_TYPE"|"SAVINGS_PLAN_ARN"|"PAYMENT_OPTION"|"AGREEMENT_END_DATE_TIME_AFTER"|"AGREEMENT_END_DATE_TIME_BEFORE"|"INVOICING_ENTITY"|"ANOMALY_TOTAL_IMPACT_ABSOLUTE"|"ANOMALY_TOTAL_IMPACT_PERCENTAGE",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
      },
      "Tags": {
        "Key": "string",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
      },
      "CostCategories": {
        "Key": "string",
        "Values": ["string", ...],
        "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
      }
    }
    ...
  ],
  "Not": {
    "Or": [
      { ... recursive ... }
      ...
    ],
    "And": [
      { ... recursive ... }
      ...
    ],
    "Not": { ... recursive ... },
    "Dimensions": {
      "Key": "AZ"|"INSTANCE_TYPE"|"LINKED_ACCOUNT"|"LINKED_ACCOUNT_NAME"|"OPERATION"|"PURCHASE_TYPE"|"REGION"|"SERVICE"|"SERVICE_CODE"|"USAGE_TYPE"|"USAGE_TYPE_GROUP"|"RECORD_TYPE"|"OPERATING_SYSTEM"|"TENANCY"|"SCOPE"|"PLATFORM"|"SUBSCRIPTION_ID"|"LEGAL_ENTITY_NAME"|"DEPLOYMENT_OPTION"|"DATABASE_ENGINE"|"CACHE_ENGINE"|"INSTANCE_TYPE_FAMILY"|"BILLING_ENTITY"|"RESERVATION_ID"|"RESOURCE_ID"|"RIGHTSIZING_TYPE"|"SAVINGS_PLANS_TYPE"|"SAVINGS_PLAN_ARN"|"PAYMENT_OPTION"|"AGREEMENT_END_DATE_TIME_AFTER"|"AGREEMENT_END_DATE_TIME_BEFORE"|"INVOICING_ENTITY"|"ANOMALY_TOTAL_IMPACT_ABSOLUTE"|"ANOMALY_TOTAL_IMPACT_PERCENTAGE",
      "Values": ["string", ...],
      "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
    },
    "Tags": {
      "Key": "string",
      "Values": ["string", ...],
      "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
    },
    "CostCategories": {
      "Key": "string",
      "Values": ["string", ...],
      "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
    }
  },
  "Dimensions": {
    "Key": "AZ"|"INSTANCE_TYPE"|"LINKED_ACCOUNT"|"LINKED_ACCOUNT_NAME"|"OPERATION"|"PURCHASE_TYPE"|"REGION"|"SERVICE"|"SERVICE_CODE"|"USAGE_TYPE"|"USAGE_TYPE_GROUP"|"RECORD_TYPE"|"OPERATING_SYSTEM"|"TENANCY"|"SCOPE"|"PLATFORM"|"SUBSCRIPTION_ID"|"LEGAL_ENTITY_NAME"|"DEPLOYMENT_OPTION"|"DATABASE_ENGINE"|"CACHE_ENGINE"|"INSTANCE_TYPE_FAMILY"|"BILLING_ENTITY"|"RESERVATION_ID"|"RESOURCE_ID"|"RIGHTSIZING_TYPE"|"SAVINGS_PLANS_TYPE"|"SAVINGS_PLAN_ARN"|"PAYMENT_OPTION"|"AGREEMENT_END_DATE_TIME_AFTER"|"AGREEMENT_END_DATE_TIME_BEFORE"|"INVOICING_ENTITY"|"ANOMALY_TOTAL_IMPACT_ABSOLUTE"|"ANOMALY_TOTAL_IMPACT_PERCENTAGE",
    "Values": ["string", ...],
    "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
  },
  "Tags": {
    "Key": "string",
    "Values": ["string", ...],
    "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
  },
  "CostCategories": {
    "Key": "string",
    "Values": ["string", ...],
    "MatchOptions": ["EQUALS"|"ABSENT"|"STARTS_WITH"|"ENDS_WITH"|"CONTAINS"|"CASE_SENSITIVE"|"CASE_INSENSITIVE"|"GREATER_THAN_OR_EQUAL", ...]
  }
}

--configuration (структура)

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

RecommendationTarget -> (строка)

Вариант просмотра рекомендаций в рамках одной семейства экземпляров или рекомендаций для экземпляров в других семействах. Значение по умолчанию — SAME_INSTANCE_FAMILY .

BenefitsConsidered -> (булево)

Вариант учета скидок RI или планов экономии при расчете экономии. Значение по умолчанию — TRUE .

Сокращенная синтаксическая запись:

RecommendationTarget=string,BenefitsConsidered=boolean

Синтаксис JSON:

{
  "RecommendationTarget": "SAME_INSTANCE_FAMILY"|"CROSS_INSTANCE_FAMILY",
  "BenefitsConsidered": true|false
}

--service (строка)

Указываемый конкретный сервис, для которого требуются рекомендации. Единственное допустимое значение для GetRightsizingRecommendation — «AmazonEC2».

--page-size (целое число)

Количество рекомендаций, которое требуется вернуть в одном объекте ответа.

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

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

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

Вывод

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

Информация об этом наборе рекомендаций.

RecommendationId -> (строка)

Идентификатор рекомендации.

GenerationTimestamp -> (строка)

Отметка времени создания рекомендации Amazon Web Services.

LookbackPeriodInDays -> (строка)

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

AdditionalMetadata -> (строка)

Дополнительные метаданные, которые могут быть применимы к рекомендации.

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

Резюме этого набора рекомендаций.

TotalRecommendationCount -> (строка)

Общее количество рекомендаций по экземплярам.

EstimatedTotalMonthlySavingsAmount -> (строка)

Общий предполагаемый объем экономии ежемесячно.

SavingsCurrencyCode -> (строка)

Код валюты, используемый Amazon Web Services для расчета экономии.

SavingsPercentage -> (строка)

Процент экономии на основе рекомендованных изменений. Он относится к общим затратам на виртуальные машины «по требованию», связанным с этими экземплярами.

RightsizingRecommendations -> (список)

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

(структура)

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

AccountId -> (строка)

Аккаунт, для которого предназначена эта рекомендация.

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

Информация о текущем экземпляре.

ResourceId -> (строка)

Идентификатор ресурса текущего экземпляра.

InstanceName -> (строка)

Имя, которое вы присвоили экземпляру. Это поле отображается пустым, если вы не задали имя экземпляру.

Tags -> (список)

Теги ресурсов распределения затрат, примененные к экземпляру.

(структура)

Доступные значения для тега.

Если Values и Key не указаны, к всем тегам применяется правило ABSENT MatchOption. То есть, выполняется фильтрация по ресурсам без тегов.

Если Key указан, а Values не указан, правило ABSENT MatchOption применяется только к тегу Key. То есть, выполняется фильтрация по ресурсам без указанного ключа тега.

Key -> (строка)

Ключ тега.

Values -> (список)

Конкретное значение тега.

(строка)

MatchOptions -> (список)

Параметры сопоставления, которые можно использовать для фильтрации результатов. MatchOptions применим только для действий, связанных с категориями затрат. Значения по умолчанию для MatchOptions - EQUALS и CASE_SENSITIVE.

(строка)

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

Подробности о ресурсе и его использовании.

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

Подробности о ресурсе Amazon EC2.

HourlyOnDemandRate -> (строка)

Часовая цена публичного предложения On-Demand для типа экземпляра.

InstanceType -> (строка)

Тип экземпляра Amazon Web Services.

Platform -> (строка)

Платформа экземпляра Amazon Web Services. Платформа представляет собой конкретное сочетание операционной системы, модели лицензирования и программного обеспечения на экземпляре.

Region -> (строка)

Регион Amazon Web Services экземпляра.

Sku -> (строка)

Артикул продукта.

Memory -> (строка)

Ёмкость памяти экземпляра Amazon Web Services.

NetworkPerformance -> (строка)

Производительность сети экземпляра Amazon Web Services.

Storage -> (строка)

Объём диска экземпляра Amazon Web Services. Не включает хранилище EBS.

Vcpu -> (строка)

Количество ядер VCPU в типе экземпляра Amazon Web Services.

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

Информация об использовании текущего экземпляра за период наблюдения.

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

Использование текущего экземпляра Amazon EC2.

MaxCpuUtilizationPercentage -> (строка)

Максимальная наблюдаемая или ожидаемая загрузка ЦП экземпляра.

MaxMemoryUtilizationPercentage -> (строка)

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

MaxStorageUtilizationPercentage -> (строка)

Максимальная наблюдаемая или ожидаемая загрузка хранилища экземпляра. Не включает хранилище EBS.

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

Поле EBS, содержащее список метрик EBS, связанных с текущим экземпляром.

EbsReadOpsPerSecond -> (строка)

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

EbsWriteOpsPerSecond -> (строка)

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

EbsReadBytesPerSecond -> (строка)

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

EbsWriteBytesPerSecond -> (строка)

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

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

Поле, содержащее список метрик дисков (локального хранилища), связанных с текущим экземпляром.

DiskReadOpsPerSecond -> (строка)

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

DiskWriteOpsPerSecond -> (строка)

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

DiskReadBytesPerSecond -> (строка)

Максимальная пропускная способность чтения в секунду.

DiskWriteBytesPerSecond -> (строка)

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

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

Поле сети, содержащее список метрик сети, связанных с текущим экземпляром.

NetworkInBytesPerSecond -> (строка)

Используемая пропускная способность входящего сетевого трафика, измеряемая в байтах в секунду (Бпс).

NetworkOutBytesPerSecond -> (строка)

Используемая пропускная способность исходящего сетевого трафика, измеряемая в байтах в секунду (Бпс).

NetworkPacketsInPerSecond -> (строка)

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

NetworkPacketsOutPerSecond -> (строка)

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

ReservationCoveredHoursInLookbackPeriod -> (строка)

Количество часов за период наблюдения, покрытых резервациями.

SavingsPlansCoveredHoursInLookbackPeriod -> (строка)

Количество часов за период наблюдения, покрытых планами экономии.

OnDemandHoursInLookbackPeriod -> (строка)

Количество часов за период наблюдения, оплаченных по тарифам On-Demand.

TotalRunningHoursInLookbackPeriod -> (строка)

Общее количество часов работы экземпляра за период наблюдения.

MonthlyCost -> (строка)

Текущая стоимость On-Demand работы этого экземпляра ежемесячно.

CurrencyCode -> (строка)

Код валюты, используемый Amazon Web Services для расчета затрат на этот экземпляр.

RightsizingType -> (строка)

Рекомендация о прекращении работы или изменении ресурса.

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

Подробности рекомендаций по изменению.

TargetInstances -> (список)

Определяет, является ли этот тип экземпляра рекомендуемой настройкой Amazon Web Services по умолчанию.

(структура)

Информация о рекомендуемом экземпляре.

EstimatedMonthlyCost -> (строка)

Ожидаемая стоимость работы этого типа экземпляра ежемесячно.

EstimatedMonthlySavings -> (строка)

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

CurrencyCode -> (строка)

Код валюты, используемый Amazon Web Services для расчета затрат на этот экземпляр.

DefaultTargetInstance -> (булево)

Определяет, является ли данная рекомендация рекомендуемой настройкой Amazon Web Services по умолчанию.

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

Подробности о целевом типе экземпляра.

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

Подробности о ресурсе Amazon EC2.

HourlyOnDemandRate -> (строка)

Часовая цена публичного предложения On-Demand для типа экземпляра.

InstanceType -> (строка)

Тип экземпляра Amazon Web Services.

Platform -> (строка)

Region -> (строка)

Регион Amazon Web Services экземпляра.

Sku -> (строка)

Артикул продукта.

Memory -> (строка)

Ёмкость памяти экземпляра Amazon Web Services.

NetworkPerformance -> (строка)

Производительность сети экземпляра Amazon Web Services.

Storage -> (строка)

Объём диска экземпляра Amazon Web Services. Не включает хранилище EBS.

Vcpu -> (строка)

Количество ядер VCPU в типе экземпляра Amazon Web Services.

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

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

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

Использование текущего экземпляра Amazon EC2.

MaxCpuUtilizationPercentage -> (строка)

Максимальная наблюдаемая или ожидаемая загрузка ЦП экземпляра.

MaxMemoryUtilizationPercentage -> (строка)

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

MaxStorageUtilizationPercentage -> (строка)

Максимальная наблюдаемая или ожидаемая загрузка хранилища экземпляра. Не включает хранилище EBS.

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

Поле EBS, содержащее список метрик EBS, связанных с текущим экземпляром.

EbsReadOpsPerSecond -> (строка)

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

EbsWriteOpsPerSecond -> (строка)

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

EbsReadBytesPerSecond -> (строка)

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

EbsWriteBytesPerSecond -> (строка)

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

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

Поле, содержащее список метрик дисков (локального хранилища), связанных с текущим экземпляром.

DiskReadOpsPerSecond -> (строка)

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

DiskWriteOpsPerSecond -> (строка)

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

DiskReadBytesPerSecond -> (строка)

Максимальная пропускная способность чтения в секунду.

DiskWriteBytesPerSecond -> (строка)

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

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

Поле сети, содержащее список метрик сети, связанных с текущим экземпляром.

NetworkInBytesPerSecond -> (строка)

Используемая пропускная способность входящего сетевого трафика, измеряемая в байтах в секунду (Бпс).

NetworkOutBytesPerSecond -> (строка)

Используемая пропускная способность исходящего сетевого трафика, измеряемая в байтах в секунду (Бпс).

NetworkPacketsInPerSecond -> (строка)

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

NetworkPacketsOutPerSecond -> (строка)

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

PlatformDifferences -> (список)

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

(строка)

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

Подробности рекомендаций по прекращению работы.

EstimatedMonthlySavings -> (строка)

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

CurrencyCode -> (строка)

Код валюты, используемый Amazon Web Services для расчета затрат на этот экземпляр.

FindingReasonCodes -> (список)

Список возможных причин, по которым генерируется рекомендация, таких как недостаточное или чрезмерное использование определенных метрик (например, ЦП, память, сеть).

(строка)

NextPageToken -> (строка)

Токен для получения следующего набора результатов.

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

Вы можете использовать Configuration для настройки рекомендаций по двум атрибутам. Вы можете выбрать просмотр рекомендаций для экземпляров в рамках одной и той же семейства экземпляров или для экземпляров в разных семействах экземпляров. Вы также можете выбрать просмотр вашей оценочной экономии, связанной с рекомендациями с учетом существующих льгот по Savings Plans или RI, или без учета их.

RecommendationTarget -> (строка)

Вариант просмотра рекомендаций в рамках одной и той же семейства экземпляров или рекомендаций для экземпляров в других семействах. Значение по умолчанию — SAME_INSTANCE_FAMILY.

BenefitsConsidered -> (булево)

Вариант учета скидок RI или Savings Plans в расчете экономии. Значение по умолчанию — TRUE.