создание-определения-категории-затрат

Описание

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

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

Синтаксис

  create-cost-category-definition
--name <value>
[--effective-start <value>]
--rule-version <value>
--rules <value>
[--default-value <value>]
[--split-charge-rules <value>]
[--resource-tags <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]

Параметры

--name (строка)

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

--effective-start (строка)

Эффективная дата начала категории затрат. Она может быть только датой начала периода выставления счетов (первый день месяца). Если дата не указана, используется первый день текущего месяца. Даты не могут быть раньше предыдущих двенадцати месяцев или в будущем.

--rule-version (строка)

Версия схемы правил в этой категории затрат.

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

CostCategoryExpression.v1

--rules (список)

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

(структура)

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

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

Значение по умолчанию для категории затрат.

Правило -> (структура)

Объект Expression, используемый для категоризации затрат. Он поддерживает измерения, теги и вложенные выражения. В настоящее время поддерживаются только следующие измерения: LINKED_ACCOUNT , SERVICE_CODE , RECORD_TYPE , LINKED_ACCOUNT_NAME , REGION и USAGE_TYPE .

RECORD_TYPE — измерение, используемое в API Cost Explorer, также поддерживается в выражениях категории затрат. Это измерение использует различные термины в зависимости от того, используете ли вы консоль или редактор API/JSON. Подробное сравнение см. в разделе Сравнение терминов в Руководстве пользователя по управлению выставлением счетов и затратами.

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

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

(строка)

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

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

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

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

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

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

(строка)

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

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

(строка)

И -> (список)

``` END_OF_DOCUMENT_MARKER

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

Примечание

Для действия 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.

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

Ключ тега.

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

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

(строка)

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

(строка)

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

Фильтр, основанный на значениях 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.

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

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

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

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

(строка)

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

(строка)

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

Значение категории затрат, если элемент строки содержит соответствующее измерение.

DimensionName -> (строка)

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

Если вы укажете LINKED_ACCOUNT_NAME, значение категории затрат основано на имени счета. Если вы укажете TAG, значение категории затрат основано на значении указанного ключа тега.

DimensionKey -> (строка)

Ключ для извлечения значений категории затрат.

Type -> (строка)

Вы можете определить тип правила CostCategoryRule как REGULAR или INHERITED_VALUE. Тип правила INHERITED_VALUE добавляет гибкость для определения правила, которое динамически наследует значение категории затрат. Это значение из значения измерения, определенного CostCategoryInheritedValueDimension. Например, предположим, что вы хотите, чтобы затраты динамически группировались на основе значения определенного ключа тега. Сначала выберите тип правила наследуемого значения, затем выберите измерение тега и укажите используемый ключ тега.

Синтаксис JSON:

[
  {
    "Value": "string",
    "Rule": {
      "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", ...]
      }
    },
    "InheritedValue": {
      "DimensionName": "LINKED_ACCOUNT_NAME"|"TAG",
      "DimensionKey": "string"
    },
    "Type": "REGULAR"|"INHERITED_VALUE"
  }
  ...
]

--default-value (строка)

Значение по умолчанию для категории затрат.

--split-charge-rules (список)

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

(структура)

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

Source -> (строка)

Значение категории затрат, которое вы хотите разделить. Это значение не может использоваться в качестве источника или целевого значения в других правилах разделения затрат. Для указания затрат без категории можно использовать пустую строку в качестве источника.

Targets -> (список)

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

(строка)

Method -> (строка)

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

Proportional - Распределяет затраты по целевым значениям на основе пропорциональной взвешенной стоимости каждого целевого значения.

Fixed - Распределяет затраты по целевым значениям на основе вашего определенного процентного распределения.

>``Even`` - Распределяет затраты равномерно по всем целевым значениям.

Parameters -> (список)

Параметры метода разделения затрат. Это необходимо только для метода FIXED.

(структура)

Параметры метода разделения затрат.

Type -> (строка)

Тип параметра.

Values -> (список)

Значения параметров.

(строка)

Синтаксис JSON:

[
  {
    "Source": "string",
    "Targets": ["string", ...],
    "Method": "FIXED"|"PROPORTIONAL"|"EVEN",
    "Parameters": [
      {
        "Type": "ALLOCATION_PERCENTAGES",
        "Values": ["string", ...]
      }
      ...
    ]
  }
  ...
]

--resource-tags (список)

Необязательный список тегов для ассоциации со специфическим ` CostCategory https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategory.html`__. Вы можете использовать теги ресурсов для управления доступом к вашим cost category с помощью политик IAM.

Каждый тег состоит из ключа и значения, и каждый ключ должен быть уникальным для ресурса. Следующие ограничения применяются к тегам ресурсов:

Несмотря на максимальное количество элементов массива 200, вы можете назначить максимум 50 пользовательских тегов одному ресурсу. Остальные зарезервированы для использования Amazon Web Services
Максимальная длина ключа — 128 символов
Максимальная длина значения — 256 символов
Ключи и значения могут содержать только буквенно-цифровые символы, пробелы и следующие символы: _.:/=+@-
Ключи и значения чувствительны к регистру
Ключи и значения обрезаются для удаления начальных и конечных пробелов
Не используйте aws: в качестве префикса для ваших ключей. Этот префикс зарезервирован для использования Amazon Web Services

(структура)

Структура тега, содержащая ключ и значение тега.

Примечание

Тегирование поддерживается только для следующих типов ресурсов Cost Explorer: ` AnomalyMonitor https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_AnomalyMonitor.html`__, ` AnomalySubscription https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_AnomalySubscription.html`__, ` CostCategory https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategory.html`__.

Key -> (строка)

Ключ, связанный с тегом.

Value -> (строка)

Значение, связанное с тегом.

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

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

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

Вывод

CostCategoryArn -> (строка)

Уникальный идентификатор вашей вновь созданной категории затрат.

EffectiveStart -> (строка)

Дата начала действия категории затрат. Может быть только датой начала выставления счетов (первый день месяца).