AWS Cost Explorer Service Update: You can now create cost categories …

…with inherited value rules and specify default values for any uncategorized costs.
aws · Mar 23, 2021 · 74dd323 · 74dd323
1 parent c8bfdee
commit 74dd323
Show file tree

Hide file tree

Showing 2 changed files with 53 additions and 11 deletions.
diff --git a/.changes/next-release/feature-AWSCostExplorerService-79990b9.json b/.changes/next-release/feature-AWSCostExplorerService-79990b9.json
@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "AWS Cost Explorer Service",
+    "contributor": "",
+    "description": "You can now create cost categories with inherited value rules and specify default values for any uncategorized costs."
+}
diff --git a/services/costexplorer/src/main/resources/codegen-resources/service-2.json b/services/costexplorer/src/main/resources/codegen-resources/service-2.json
@@ -720,10 +720,32 @@
         "ProcessingStatus":{
           "shape":"CostCategoryProcessingStatusList",
           "documentation":"<p> The list of processing statuses for Cost Management products for a specific cost category. </p>"
-        }
+        },
+        "DefaultValue":{"shape":"CostCategoryValue"}
       },
       "documentation":"<p>The structure of Cost Categories. This includes detailed metadata and the set of rules for the <code>CostCategory</code> object.</p>"
     },
+    "CostCategoryInheritedValueDimension":{
+      "type":"structure",
+      "members":{
+        "DimensionName":{
+          "shape":"CostCategoryInheritedValueDimensionName",
+          "documentation":"<p>The name of dimension for which to group costs.</p> <p>If you specify <code>LINKED_ACCOUNT_NAME</code>, the cost category value will be based on account name. If you specify <code>TAG</code>, the cost category value will be based on the value of the specified tag key.</p>"
+        },
+        "DimensionKey":{
+          "shape":"GenericString",
+          "documentation":"<p>The key to extract cost category values.</p>"
+        }
+      },
+      "documentation":"<p>When creating or updating a cost category, you can define the <code>CostCategoryRule</code> rule type as <code>INHERITED_VALUE</code>. This rule type adds the flexibility of defining a rule that dynamically inherits the cost category value from the dimension value defined by <code>CostCategoryInheritedValueDimension</code>. For example, if you wanted to dynamically group costs based on the value of a specific tag key, you would first choose an inherited value rule type, then choose the tag dimension and specify the tag key to use.</p>"
+    },
+    "CostCategoryInheritedValueDimensionName":{
+      "type":"string",
+      "enum":[
+        "LINKED_ACCOUNT_NAME",
+        "TAG"
+      ]
+    },
     "CostCategoryMaxResults":{
       "type":"integer",
       "max":100,
@@ -732,7 +754,7 @@
     "CostCategoryName":{
       "type":"string",
       "documentation":"<p>The unique name of the Cost Category.</p>",
-      "max":255,
+      "max":50,
       "min":1,
       "pattern":"^(?! )[\\p{L}\\p{N}\\p{Z}-_]*(?<! )$"
     },
@@ -785,7 +807,8 @@
         "Values":{
           "shape":"CostCategoryValuesList",
           "documentation":"<p> A list of unique cost category values in a specific cost category. </p>"
-        }
+        },
+        "DefaultValue":{"shape":"CostCategoryValue"}
       },
       "documentation":"<p>A reference to a Cost Category containing only enough information to identify the Cost Category.</p> <p>You can use this information to retrieve the full Cost Category information using <code>DescribeCostCategory</code>.</p>"
     },
@@ -795,19 +818,30 @@
     },
     "CostCategoryRule":{
       "type":"structure",
-      "required":[
-        "Value",
-        "Rule"
-      ],
       "members":{
         "Value":{"shape":"CostCategoryValue"},
         "Rule":{
           "shape":"Expression",
           "documentation":"<p>An <a href=\"https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html\">Expression</a> object used to categorize costs. This supports dimensions, tags, and nested expressions. Currently the only dimensions supported are <code>LINKED_ACCOUNT</code>, <code>SERVICE_CODE</code>, <code>RECORD_TYPE</code>, and <code>LINKED_ACCOUNT_NAME</code>.</p> <p>Root level <code>OR</code> is not supported. We recommend that you create a separate rule instead.</p> <p> <code>RECORD_TYPE</code> is a dimension used for Cost Explorer APIs, and is also supported for Cost Category expressions. This dimension uses different terms, depending on whether you're using the console or API/JSON editor. For a detailed comparison, see <a href=\"https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/manage-cost-categories.html#cost-categories-terms\">Term Comparisons</a> in the <i>AWS Billing and Cost Management User Guide</i>.</p>"
+        },
+        "InheritedValue":{
+          "shape":"CostCategoryInheritedValueDimension",
+          "documentation":"<p>The value the line item will be categorized as, if the line item contains the matched dimension.</p>"
+        },
+        "Type":{
+          "shape":"CostCategoryRuleType",
+          "documentation":"<p>You can define the <code>CostCategoryRule</code> rule type as either <code>REGULAR</code> or <code>INHERITED_VALUE</code>. The <code>INHERITED_VALUE</code> rule type adds the flexibility of defining a rule that dynamically inherits the cost category value from the dimension value defined by <code>CostCategoryInheritedValueDimension</code>. For example, if you wanted to dynamically group costs based on the value of a specific tag key, you would first choose an inherited value rule type, then choose the tag dimension and specify the tag key to use.</p>"
         }
       },
       "documentation":"<p>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.</p>"
     },
+    "CostCategoryRuleType":{
+      "type":"string",
+      "enum":[
+        "REGULAR",
+        "INHERITED_VALUE"
+      ]
+    },
     "CostCategoryRuleVersion":{
       "type":"string",
       "documentation":"<p>The rule schema version in this particular Cost Category.</p>",
@@ -832,8 +866,8 @@
     },
     "CostCategoryValue":{
       "type":"string",
-      "documentation":"<p>The value a line item will be categorized as, if it matches the rule.</p>",
-      "max":255,
+      "documentation":"<p>The default value for the cost category.</p>",
+      "max":50,
       "min":1,
       "pattern":"^(?! )[\\p{L}\\p{N}\\p{Z}-_]*(?<! )$"
     },
@@ -1005,7 +1039,8 @@
         "Rules":{
           "shape":"CostCategoryRulesList",
           "documentation":"<p>The Cost Category rules used to categorize costs. For more information, see <a href=\"https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategoryRule.html\">CostCategoryRule</a>.</p>"
-        }
+        },
+        "DefaultValue":{"shape":"CostCategoryValue"}
       }
     },
     "CreateCostCategoryDefinitionResponse":{
@@ -3981,7 +4016,8 @@
         "Rules":{
           "shape":"CostCategoryRulesList",
           "documentation":"<p>The <code>Expression</code> object used to categorize costs. For more information, see <a href=\"https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategoryRule.html\">CostCategoryRule </a>. </p>"
-        }
+        },
+        "DefaultValue":{"shape":"CostCategoryValue"}
       }
     },
     "UpdateCostCategoryDefinitionResponse":{