get-cost-forecast

Описание

Возвращает прогноз расходов от Amazon Web Services на указанный период прогнозирования, основанный на ваших прошлых затратах.

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

Синтаксис

  get-cost-forecast
--time-period <value>
--metric <value>
--granularity <value>
[--filter <value>]
[--billing-view-arn <value>]
[--prediction-interval-level <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 (структура)

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

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

--metric (строка)

Метрика, которую Cost Explorer использует для создания прогноза. Дополнительную информацию о смешанных и несмешанных ставках см. в статье Why does the “blended” annotation appear on some line items in my bill?.

Допустимые значения для вызова GetCostForecast следующие:

AMORTIZED_COST
BLENDED_COST
NET_AMORTIZED_COST
NET_UNBLENDED_COST
UNBLENDED_COST

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

BLENDED_COST
UNBLENDED_COST
AMORTIZED_COST
NET_UNBLENDED_COST
NET_AMORTIZED_COST
USAGE_QUANTITY
NORMALIZED_USAGE_AMOUNT

--granularity (строка)

Требуемая степень детализации прогноза. Вы можете получить прогнозы за 3 месяца с DAILY детализацией или за 12 месяцев с MONTHLY детализацией.

Операция GetCostForecast поддерживает только детализации DAILY и MONTHLY.

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

DAILY
MONTHLY
HOURLY

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

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

AZ
INSTANCE_TYPE
LINKED_ACCOUNT
OPERATION
PURCHASE_TYPE
REGION
SERVICE
USAGE_TYPE
USAGE_TYPE_GROUP
RECORD_TYPE
OPERATING_SYSTEM
TENANCY
SCOPE
PLATFORM
SUBSCRIPTION_ID
LEGAL_ENTITY_NAME
DEPLOYMENT_OPTION
DATABASE_ENGINE
INSTANCE_TYPE_FAMILY
BILLING_ENTITY
RESERVATION_ID
SAVINGS_PLAN_ARN

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

Возвращаются результаты, соответствующие любому объекту 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 сочетание OR и NOT не поддерживается. OR не поддерживается между различными измерениями или измерениями и тегами. Операторы NOT не поддерживаются. Измерения также ограничены LINKED_ACCOUNT, REGION или RIGHTSIZING_TYPE.

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

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

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

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

И -> (список)

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

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

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

Конкретные Dimension для Expression.

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

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

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

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.

(строка)

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

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

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

Уникальное имя категории расходов.

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

Конкретное значение категории расходов.

(строка)

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

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

(строка)

И -> (список)

Возвращать результаты, соответствующие обоим объектам 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.

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

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

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

И -> (список)

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

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

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

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

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

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

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

--billing-view-arn (строка)

Идентификатор Amazon Resource Name (ARN), уникально определяющий конкретный вид выставления счетов. ARN используется для указания конкретного вида выставления счетов, с которым вы хотите взаимодействовать или из которого хотите получить информацию при выполнении вызовов API, связанных с услугами выставления счетов и управления затратами Amazon Web Services. BillingViewArn можно получить, вызвав API ListBillingViews.

--prediction-interval-level (целое число)

Cost Explorer всегда возвращает прогноз среднего значения как единственную точку. Вы можете запросить интервал прогноза вокруг среднего значения, указав уровень доверия. Чем выше уровень доверия, тем увереннее Cost Explorer, что фактическое значение попадает в интервал прогноза. Более высокие уровни доверия приводят к более широким интервалам прогноза.

--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 (строка)

Файл с корневым сертификатом для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной строкой base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое отображается в двоичный блок fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую независимо от параметра cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для заданного cli-binary-format.

base64
raw-in-base64-out

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

Отключить кли-пейджер для вывода.

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

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

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

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

Вывод

Всего -> (структура)

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

Сумма -> (строка)

Фактическое число, представляющее метрику.

Единица -> (строка)

Единица измерения метрики.

ForecastResultsByTime -> (список)

Прогнозы для вашего запроса в порядке. Для прогнозов DAILY это список дней. Для прогнозов MONTHLY это список месяцев.

(структура)

Прогноз, созданный для вашего запроса.

Период -> (структура)

Период времени, охватываемый прогнозом.

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

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

Конец -> (строка)

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

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

Среднее значение прогноза.

Нижняя граница интервала прогноза -> (строка)

Нижняя граница интервала прогноза.

Верхняя граница интервала прогноза -> (строка)

Верхняя граница интервала прогноза.