get-reservation-coverage

Описание

Получает охват резервирования для вашей учетной записи, который вы можете использовать, чтобы увидеть, сколько вашего использования Amazon Elastic Compute Cloud, Amazon ElastiCache, Amazon Relational Database Service или Amazon Redshift покрывается резервированием. Учетная запись управления организацией может увидеть охват связанных учетных записей-участников. Это поддерживает измерения, категории затрат и вложенные выражения. Для любого периода времени вы можете отфильтровать данные об использовании резервирования по следующим измерениям:

AZ
CACHE_ENGINE
DATABASE_ENGINE
DEPLOYMENT_OPTION
INSTANCE_TYPE
LINKED_ACCOUNT
OPERATING_SYSTEM
PLATFORM
REGION
SERVICE
TAG
TENANCY

Чтобы определить допустимые значения для измерения, используйте операцию GetDimensionValues.

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

Синтаксис

  get-reservation-coverage
--time-period <value>
[--group-by <value>]
[--granularity <value>]
[--filter <value>]
[--metrics <value>]
[--next-page-token <value>]
[--sort-by <value>]
[--max-results <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]

Параметры

--time-period (структура)

Начальная и конечная даты периода, для которого вы хотите получить данные об охвате резервирования. Вы можете получить данные за максимальный период 13 месяцев: последние 12 месяцев и текущий месяц. Начальная дата включительная, а конечная — исключительная. Например, если start — 2017-01-01, а end — 2017-05-01, то данные затрат и использования извлекаются с 2017-01-01 по 2017-04-30 включительно, но не включая 2017-05-01.

Start -> (строка)

Начало периода времени. Начальная дата включительная. Например, если start — 2017-01-01, Amazon Web Services извлекает данные затрат и использования, начиная с 2017-01-01 до конечной даты. Начальная дата должна быть равна или не позднее текущей даты, чтобы избежать ошибки проверки.

End -> (строка)

Конец периода времени. Конечная дата исключительная. Например, если end — 2017-05-01, Amazon Web Services извлекает данные затрат и использования с начальной даты до, но не включая, 2017-05-01.

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

Start=string,End=string

Синтаксис JSON:

{
  "Start": "string",
  "End": "string"
}

--group-by (список)

Вы можете сгруппировать данные по следующим атрибутам:

AZ
CACHE_ENGINE
DATABASE_ENGINE
DEPLOYMENT_OPTION
INSTANCE_TYPE
INVOICING_ENTITY
LINKED_ACCOUNT
OPERATING_SYSTEM
PLATFORM
REGION
TENANCY

(структура)

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

Type -> (строка)

Строка, представляющая тип группы.

Key -> (строка)

Строка, представляющая ключ для указанной группы.

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

Type=string,Key=string ...

Синтаксис JSON:

[
  {
    "Type": "DIMENSION"|"TAG"|"COST_CATEGORY",
    "Key": "string"
  }
  ...
]

--granularity (строка)

Грань данных затрат Amazon Web Services для резервирования. Допустимые значения — MONTHLY и DAILY.

Если GroupBy установлено, Granularity не может быть установлено. Если Granularity не установлено, объект ответа не включает Granularity, ни MONTHLY, ни DAILY.

Операция GetReservationCoverage поддерживает только грани DAILY и MONTHLY.

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

DAILY
MONTHLY
HOURLY

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

Фильтры данных использования по измерениям. Вы можете фильтровать по следующим измерениям:

AZ
CACHE_ENGINE
DATABASE_ENGINE
DEPLOYMENT_OPTION
INSTANCE_TYPE
LINKED_ACCOUNT
OPERATING_SYSTEM
PLATFORM
REGION
SERVICE
TAG
TENANCY

GetReservationCoverage использует тот же объект Expression, что и другие операции, но среди каждого измерения поддерживается только AND. Вы можете вложить только один уровень вглубь. Если для измерения есть несколько значений, они объединяются операцией ИЛИ.

Если вы не предоставляете фильтр SERVICE, Cost Explorer по умолчанию использует EC2.

Также поддерживается категория затрат.

Or -> (список)

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

(структура)

Используйте 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 комбинация ИЛИ и НЕ не поддерживается. ИЛИ не поддерживается между различными измерениями или измерениями и тегами. Операторы НЕ не поддерживаются. Измерения также ограничены LINKED_ACCOUNT, REGION или RIGHTSIZING_TYPE.

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

Or -> (список)

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

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

And -> (список)

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

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

(… рекурсивно …)Dimensions -> (структура)

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

Key -> (строка)

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

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

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

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

Values -> (список)

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

(строка)

MatchOptions -> (список)

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

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

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

(строка)

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

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

Key -> (строка)

Ключ тега.

Values -> (список)

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

(строка)

MatchOptions -> (список)

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

(строка)

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

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

Key -> (строка)

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

Values -> (список)

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

(строка)

MatchOptions -> (список)

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

(строка)

And -> (список)

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

(структура)

Используйте 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 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.

Or -> (список)

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

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

And -> (список)

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

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

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

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

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

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

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

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

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

(строка)

MatchOptions -> (список)

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

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

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

(строка)

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

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

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

Ключ тега.

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

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

(строка)

MatchOptions -> (список)

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

(строка)

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

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

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

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

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

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

(строка)

MatchOptions -> (список)

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

(строка)

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

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

Or -> (список)

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

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

And -> (список)

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

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

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

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

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

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

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

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

(строка)

MatchOptions -> (список)

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

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

(строка)

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

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

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

Ключ тега.

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

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

(строка)

MatchOptions -> (список)

(строка)

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

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

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

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

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

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

(строка)

MatchOptions -> (список)

(строка)

Размеры -> (структура)

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

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

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

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

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

(строка)

MatchOptions -> (список)

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

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

(строка)

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

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

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

Ключ тега.

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

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

(строка)

MatchOptions -> (список)

(строка)

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

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

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

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

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

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

(строка)

MatchOptions -> (список)

(строка)

Синтаксис 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", ...]
  }
}

--metrics (список)

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

Допустимые значения: Hour , Unit , и Cost . Вы можете использовать несколько значений в запросе.

(строка)

Синтаксис:

"string" "string" ...

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

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

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

Значение, по которому вы хотите отсортировать данные.

Для Key поддерживаются следующие значения:

OnDemandCost
CoverageHoursPercentage
OnDemandHours
ReservedHours
TotalRunningHours
CoverageNormalizedUnitsPercentage
OnDemandNormalizedUnits
ReservedNormalizedUnits
TotalRunningNormalizedUnits
Time

Поддерживаемые значения для SortOrder — ASCENDING или DESCENDING .

Key -> (строка)

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

SortOrder -> (строка)

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

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

Key=string,SortOrder=string

Синтаксис JSON:

{
  "Key": "string",
  "SortOrder": "ASCENDING"|"DESCENDING"
}

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

Максимальное количество объектов, возвращенных для этого запроса. Если доступно больше объектов, в ответе Amazon Web Services предоставляется значение NextPageToken, которое можно использовать в последующем вызове для получения следующей партии объектов.

--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 для вывода.

--cli-auto-prompt (логическое значение)

Автоматически запросить параметры входных данных CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запроса параметров входных данных CLI.

Примеры

Примечание

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

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

Получение информации о покрытии резервирования для экземпляров EC2 t2.nano в регионе us-east-1

В этом примере извлекается информация о покрытии резервирования для экземпляров EC2 t2.nano в регионе us-east-1 за период июль-сентябрь 2017 года.

Команда:

aws ce get-reservation-coverage --time-period Start=2017-07-01,End=2017-10-01 --group-by Type=Dimension,Key=REGION --filter file://filters.json

filters.json:

{
   "And": [
     {
       "Dimensions": {
         "Key": "INSTANCE_TYPE",
         "Values": [
           "t2.nano"
         ]
       },
       "Dimensions": {
         "Key": "REGION",
         "Values": [
           "us-east-1"
         ]
       }
     }
   ]
 }

Вывод:

{
   "TotalSize": 6,
   "DimensionValues": [
       {
           "Attributes": {},
           "Value": "Amazon ElastiCache"
       },
       {
           "Attributes": {},
           "Value": "EC2 - Other"
       },
       {
           "Attributes": {},
           "Value": "Amazon Elastic Compute Cloud - Compute"
       },
       {
           "Attributes": {},
           "Value": "Amazon Elastic Load Balancing"
       },
       {
           "Attributes": {},
           "Value": "Amazon Elastic MapReduce"
       },
       {
           "Attributes": {},
           "Value": "Amazon Elasticsearch Service"
       }
   ],
   "ReturnSize": 6
}

Вывод

CoveragesByTime -> (список)

Количество времени, охваченного вашими бронированиями.

(структура)

Покрытие бронирования за указанный период, в часах.

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

Период, за который использовалось это покрытие.

Start -> (строка)

Начало периода времени. Дата начала включительно. Например, если start является 2017-01-01 , Amazon Web Services извлекает данные о стоимости и использовании, начиная с 2017-01-01 и до даты окончания. Дата начала должна быть равна или не позднее текущей даты, чтобы избежать ошибки валидации.

End -> (строка)

Конец периода времени. Дата окончания исключается. Например, если end является 2017-05-01 , Amazon Web Services извлекает данные о стоимости и использовании с даты начала до, но не включая, 2017-05-01 .

Groups -> (список)

Группы экземпляров, охваченные бронированием.

(структура)

Группа бронирований, которые разделяют набор атрибутов.

Attributes -> (карта)

Атрибуты для этой группы бронирований.

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

значение -> (строка)

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

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

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

Объем использования экземпляров, охваченный бронированием, в часах.

OnDemandHours -> (строка)

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

ReservedHours -> (строка)

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

TotalRunningHours -> (строка)

Общее использование экземпляров в часах.

CoverageHoursPercentage -> (строка)

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

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

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

OnDemandNormalizedUnits -> (строка)

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

ReservedNormalizedUnits -> (строка)

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

TotalRunningNormalizedUnits -> (строка)

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

CoverageNormalizedUnitsPercentage -> (строка)

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

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

Объем затрат, охваченных бронированием.

OnDemandCost -> (строка)

Стоимость On-Demand экземпляра.

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

Общее покрытие бронирования в часах.

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

Объем использования экземпляров, охваченный бронированием, в часах.

OnDemandHours -> (строка)

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

ReservedHours -> (строка)

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

TotalRunningHours -> (строка)

Общее использование экземпляров в часах.

CoverageHoursPercentage -> (строка)

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

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

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

OnDemandNormalizedUnits -> (строка)

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

ReservedNormalizedUnits -> (строка)

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

TotalRunningNormalizedUnits -> (строка)

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

CoverageNormalizedUnitsPercentage -> (строка)

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

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

Объем затрат, охваченных бронированием.

OnDemandCost -> (строка)

Стоимость On-Demand экземпляра.

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

Общий объем использования экземпляров, охваченный бронированием.

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

Объем использования экземпляров, охваченный бронированием, в часах.

OnDemandHours -> (строка)

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

ReservedHours -> (строка)

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

TotalRunningHours -> (строка)

Общее использование экземпляров в часах.

CoverageHoursPercentage -> (строка)

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

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

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

OnDemandNormalizedUnits -> (строка)

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

ReservedNormalizedUnits -> (строка)

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

TotalRunningNormalizedUnits -> (строка)

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

CoverageNormalizedUnitsPercentage -> (строка)

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

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

Объем затрат, охваченных бронированием.

OnDemandCost -> (строка)

Стоимость On-Demand экземпляра.

NextPageToken -> (строка)

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

END_OF_DOCUMENT_MARKER