get-reservation-purchase-recommendation

Описание

Получение рекомендаций по приобретению резервирования. Эти рекомендации могут помочь снизить ваши расходы. Резервирование предоставляет скидочную почасовую ставку (до 75%) по сравнению с ценами на оплату по мере использования.

Amazon Web Services генерирует свои рекомендации, определяя ваше использование по мере необходимости в определенный период времени и группируя ваше использование по категориям, которые подходят для резервирования. После того, как Amazon Web Services получит эти категории, он моделирует каждую комбинацию резервирования в каждой категории использования, чтобы определить оптимальное количество каждого типа зарезервированного экземпляра (RI) для приобретения, чтобы максимизировать ожидаемую экономию.

Например, Amazon Web Services автоматически агрегирует ваше использование Amazon EC2 Linux, совместного использования и семейства c4 в регионе США Запад (Орегон) и рекомендует приобрести размерно-гибкие региональные резервирования для применения к использованию семейства c4. Amazon Web Services рекомендует экземпляр минимального размера в семействе экземпляров. Это упрощает приобретение размерно-гибкого зарезервированного экземпляра (RI). Amazon Web Services также отображает равное количество нормализованных единиц. Таким образом, вы можете приобрести любой размер экземпляра, который вам нужен. В этом примере ваша рекомендация по RI — это c4.large, поскольку это экземпляр минимального размера в семействе экземпляров c4.

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

Синтаксис

  get-reservation-purchase-recommendation
[--account-id <value>]
--service <value>
[--filter <value>]
[--account-scope <value>]
[--lookback-period-in-days <value>]
[--term-in-years <value>]
[--payment-option <value>]
[--service-specification <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]

Параметры

--account-id (строка)

Идентификатор учетной записи, связанный с рекомендацией.

--service (строка)

Услуга, для которой требуются рекомендации.

--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"] }}} ] }

Примечание

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

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

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

И -> (список)

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

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

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

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

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

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

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

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

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

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

(строка)

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

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

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", ...]
  }
}

--account-scope (строка)

Область учётной записи, для которой вы хотите получить рекомендации. Amazon Web Services рассчитывает рекомендации, включая учётную запись управления и дочерние учётные записи, если значение установлено в PAYER. Если значение установлено в LINKED, рекомендации рассчитываются только для отдельных дочерних учётных записей.

Возможные значения:

PAYER
LINKED

--lookback-period-in-days (строка)

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

Возможные значения:

SEVEN_DAYS
THIRTY_DAYS
SIXTY_DAYS

--term-in-years (строка)

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

Возможные значения:

ONE_YEAR
THREE_YEARS

--payment-option (строка)

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

Возможные значения:

NO_UPFRONT
PARTIAL_UPFRONT
ALL_UPFRONT
LIGHT_UTILIZATION
MEDIUM_UTILIZATION
HEAVY_UTILIZATION

--service-specification (структура)

Технические характеристики оборудования для виртуальных машин, для которых вы хотите получить рекомендации, например, стандартные или конвертируемые экземпляры Amazon EC2.

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

Технические характеристики оборудования Amazon EC2, для которых Amazon Web Services должно предоставить рекомендации.

OfferingClass -> (строка)

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

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

EC2Specification={OfferingClass=string}

Синтаксис JSON:

{
  "EC2Specification": {
    "OfferingClass": "STANDARD"|"CONVERTIBLE"
  }
}

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

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

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

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

--cli-input-yaml | --generate-cli-skeleton (строка) Читает аргументы из предоставленной строки 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.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробнее см. руководство «Начало работы» в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры нужно адаптировать к правилам цитирования вашей терминальной оболочки. См. раздел «Использование кавычек со строками» в Руководстве пользователя AWS CLI.

Для получения рекомендаций по резервациям для частично предоплаченных RIs EC2 с трёхлетним сроком

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

aws ce get-reservation-purchase-recommendation \
    --service "Amazon Redshift" \
    --lookback-period-in-days SIXTY_DAYS \
    --term-in-years THREE_YEARS \
    --payment-option PARTIAL_UPFRONT

Вывод:

{
    "Recommendations": [],
    "Metadata": {
        "GenerationTimestamp": "2018-08-08T15:20:57Z",
        "RecommendationId": "00d59dde-a1ad-473f-8ff2-iexample3330b"
    }
}

Вывод

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

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

RecommendationId -> (строка)

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

GenerationTimestamp -> (строка)

Отметка времени, когда Amazon Web Services создало рекомендацию.

AdditionalMetadata -> (строка)

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

Recommendations -> (список)

Рекомендации по резервированию для покупки.

(структура)

Конкретное резервирование, которое Amazon Web Services рекомендует приобрести.

AccountScope -> (строка)

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

LookbackPeriodInDays -> (строка)

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

TermInYears -> (строка)

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

PaymentOption -> (строка)

Способ оплаты за резервирование (например, AllUpfront или NoUpfront).

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

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

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

Технические характеристики Amazon EC2, для которых вы хотите получить рекомендации от Amazon Web Services.

OfferingClass -> (строка)

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

RecommendationDetails -> (список)

Подробности о рекомендуемых покупках.

(структура)

Подробности о рекомендуемой покупке резервирования.

AccountId -> (строка)

Учетная запись, для которой предназначена эта рекомендация по резервированию экземпляра (RI).

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

Подробности о резервированиях, которые Amazon Web Services рекомендует приобрести.

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

Резервирования Amazon EC2, которые Amazon Web Services рекомендует приобрести.

Family -> (строка)

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

InstanceType -> (строка)

Тип экземпляра, который Amazon Web Services рекомендует.

Region -> (строка)

Регион Amazon Web Services рекомендуемого резервирования.

AvailabilityZone -> (строка)

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

Platform -> (строка)

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

Tenancy -> (строка)

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

CurrentGeneration -> (булево)

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

SizeFlexEligible -> (булево)

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

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

Резервирования Amazon RDS, которые Amazon Web Services рекомендует приобрести.

Family -> (строка)

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

InstanceType -> (строка)

Тип экземпляра, который Amazon Web Services рекомендует.

Region -> (строка)

Регион Amazon Web Services рекомендуемого резервирования.

DatabaseEngine -> (строка)

Двигатель базы данных, который поддерживает рекомендуемое резервирование.

DatabaseEdition -> (строка)

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

DeploymentOption -> (строка)

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

LicenseModel -> (строка)

Модель лицензирования, которую поддерживает рекомендуемое резервирование.

CurrentGeneration -> (булево)

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

SizeFlexEligible -> (булево)

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

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

Резервирования Amazon Redshift, которые Amazon Web Services рекомендует приобрести.

Family -> (строка)

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

NodeType -> (строка)

Тип узла, который Amazon Web Services рекомендует.

Region -> (строка)

Регион Amazon Web Services рекомендуемого резервирования.

CurrentGeneration -> (булево)

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

SizeFlexEligible -> (булево)

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

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

Резервирования ElastiCache, которые Amazon Web Services рекомендует приобрести.

Family -> (строка)

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

NodeType -> (строка)

Тип узла, который Amazon Web Services рекомендует.

Region -> (строка)

Регион Amazon Web Services рекомендуемого резервирования.

ProductDescription -> (строка)

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

CurrentGeneration -> (булево)

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

SizeFlexEligible -> (булево)

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

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

Резервирования Amazon OpenSearch Service, которые Amazon Web Services рекомендует приобрести.

InstanceClass -> (строка)

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

InstanceSize -> (строка)

Размер экземпляра, который Amazon Web Services рекомендует.

Region -> (строка)

Регион Amazon Web Services рекомендуемого резервирования.

CurrentGeneration -> (булево)

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

SizeFlexEligible -> (булево)

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

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

Резервирования MemoryDB, которые Amazon Web Services рекомендует приобрести.

Family -> (строка)

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

NodeType -> (строка)

Тип узла рекомендуемого резервирования.

Region -> (строка)

Регион Amazon Web Services рекомендуемого резервирования.

CurrentGeneration -> (булево)

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

SizeFlexEligible -> (булево)

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

RecommendedNumberOfInstancesToPurchase -> (строка)

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

RecommendedNormalizedUnitsToPurchase -> (строка)

Количество нормализованных единиц, которые Amazon Web Services рекомендует приобрести.

MinimumNumberOfInstancesUsedPerHour -> (строка)

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

MinimumNormalizedUnitsUsedPerHour -> (строка)

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

MaximumNumberOfInstancesUsedPerHour -> (строка)

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

MaximumNormalizedUnitsUsedPerHour -> (строка)

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

AverageNumberOfInstancesUsedPerHour -> (строка)

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

AverageNormalizedUnitsUsedPerHour -> (строка)

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

AverageUtilization -> (строка)

Средняя загрузка ваших экземпляров. Amazon Web Services использует это для расчета рекомендуемых покупок резервирования.

EstimatedBreakEvenInMonths -> (строка)

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

CurrencyCode -> (строка)

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

EstimatedMonthlySavingsAmount -> (строка)

Ожидаемая экономия в месяц по этой рекомендации.

EstimatedMonthlySavingsPercentage -> (строка)

Ожидаемая экономия в месяц по этой рекомендации, выраженная в процентах от общих затрат.

EstimatedMonthlyOnDemandCost -> (строка)

Ожидаемые затраты на On-Demand экземпляры в месяц.

EstimatedReservationCostForLookbackPeriod -> (строка)

Ожидаемые затраты за весь период использования, если у вас было резервирование.

UpfrontCost -> (строка)

Первоначальные затраты на покупку этого экземпляра.

RecurringStandardMonthlyCost -> (строка)

Постоянные ежемесячные затраты на этот экземпляр.

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

Подробности о резервированиях, которые Amazon Web Services рекомендует приобрести.

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

Резервирования DynamoDB, которые Amazon Web Services рекомендует приобрести.

CapacityUnits -> (строка)

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

Region -> (строка)

Регион Amazon Web Services рекомендуемого резервирования.

RecommendedNumberOfCapacityUnitsToPurchase -> (строка)

Количество резервируемых единиц емкости, которые Amazon Web Services рекомендует приобрести.

MinimumNumberOfCapacityUnitsUsedPerHour -> (строка)

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

MaximumNumberOfCapacityUnitsUsedPerHour -> (строка)

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

AverageNumberOfCapacityUnitsUsedPerHour -> (строка)

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

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

Краткое описание рекомендуемой покупки.

TotalEstimatedMonthlySavingsAmount -> (string)

Общая сумма, которую Amazon Web Services оценивает, что эта рекомендация может сэкономить вам в месяц.

TotalEstimatedMonthlySavingsPercentage -> (string)

Общая сумма, которую Amazon Web Services оценивает, что эта рекомендация может сэкономить вам в месяц, в процентах от ваших расходов.

CurrencyCode -> (string)

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

NextPageToken -> (string)

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