Syntax Properties Return values Examples See also

AWS::CE::CostCategory

The AWS::CE::CostCategory resource creates groupings of cost that you can use across products in the Amazon Billing and Cost Management console, such as Cost Explorer and Amazon Budgets. For more information, see Managing Your Costs with Cost Categories in the Amazon Billing and Cost Management User Guide.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON


{
  "Type" : "AWS::CE::CostCategory",
  "Properties" : {
      "DefaultValue" : String,
      "Name" : String,
      "Rules" : String,
      "RuleVersion" : String,
      "SplitChargeRules" : String
    }
}

YAML


Type: AWS::CE::CostCategory
Properties:
  DefaultValue: String
  Name: String
  Rules: String
  RuleVersion: String
  SplitChargeRules: String

Properties

DefaultValue

The default value for the cost category.

Required: No

Type: String

Minimum: 1

Maximum: 50

Update requires: No interruption

Name

The unique name of the Cost Category.

Required: Yes

Type: String

Minimum: 1

Maximum: 50

Update requires: Replacement

Rules

The array of CostCategoryRule in JSON array format.

Note

Rules are processed in order. If there are multiple rules that match the line item, then the first rule to match is used to determine that Cost Category value.

Required: Yes

Type: String

Minimum: 1

Maximum: 500

Update requires: No interruption

RuleVersion

The rule schema version in this particular Cost Category.

Required: Yes

Type: String

Allowed values: CostCategoryExpression.v1

Update requires: No interruption

SplitChargeRules

The split charge rules that are used to allocate your charges between your Cost Category values.

Required: No

Type: String

Minimum: 1

Maximum: 10

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the Arn of the Cost Category that is created by the template.

For more information about using the Ref function, see Ref.

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

Arn: The unique identifier for your Cost Category.
EffectiveStart: The Cost Category's effective start date.

Examples

Cost Category Department with two rules

The following example creates a Cost Category "Department" with two rules.

JSON


{
  "CostCategoryDepartment": {
    "Type": "AWS::CE::CostCategory",
    "Properties": {
      "Name": "Department",
      "RuleVersion": "CostCategoryExpression.v1",
      "Rules": "[
        {
          \"Value\":\"Engineering\",
          \"Rule\": {
            \"Dimensions\": {
            \"Key\": \"LINKED_ACCOUNT\",
            \"Values\": [ \"111111111111\" ]
            }
          }
        },
        {
          \"Value\": \"Marketing\",
          \"Rule\": {
            \"Dimensions\": {
            \"Key\": \"LINKED_ACCOUNT\",
            \"Values\": [ \"222222222222\" ] 
            }
          } 
        } 
        ]"
      }
    }
  }

YAML



  CostCategoryDepartment:
    Type: 'AWS::CE::CostCategory'
    Properties:
      Name: Department
      RuleVersion: CostCategoryExpression.v1
      Rules: '
        [
          {
            "Value":"Engineering",
            "Rule": {
              "Dimensions": {
                "Key": "LINKED_ACCOUNT",
                "Values": [ "111111111111" ]
          }
        }
      },
      {
        "Value":"Marketing",
        "Rule": {
          "Dimensions": {
          "Key": "LINKED_ACCOUNT",
          "Values": [ "222222222222" ]
          }
        }

    ]'