Skip to content

Commit de523bf

Browse files
author
AWS
committed
AWS Cost Explorer Service Update: This release introduces Cost Comparison feature (GetCostAndUsageComparisons, GetCostComparisonDrivers) allowing you find cost variations across multiple dimensions and identify key drivers of spending changes.
1 parent c06ae8a commit de523bf

File tree

3 files changed

+260
-10
lines changed

3 files changed

+260
-10
lines changed

‎.changes/next-release/feature-AWSCostExplorerService-8d5c354.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"type": "feature",
3+
"category": "AWS Cost Explorer Service",
4+
"contributor": "",
5+
"description": "This release introduces Cost Comparison feature (GetCostAndUsageComparisons, GetCostComparisonDrivers) allowing you find cost variations across multiple dimensions and identify key drivers of spending changes."
6+
}

‎services/costexplorer/src/main/resources/codegen-resources/paginators-1.json

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,18 @@
1818
"limit_key": "MaxResults",
1919
"result_key": "AnomalySubscriptions"
2020
},
21+
"GetCostAndUsageComparisons": {
22+
"input_token": "NextPageToken",
23+
"output_token": "NextPageToken",
24+
"limit_key": "MaxResults",
25+
"result_key": "CostAndUsageComparisons"
26+
},
27+
"GetCostComparisonDrivers": {
28+
"input_token": "NextPageToken",
29+
"output_token": "NextPageToken",
30+
"limit_key": "MaxResults",
31+
"result_key": "CostComparisonDrivers"
32+
},
2133
"GetSavingsPlansCoverage": {
2234
"input_token": "NextToken",
2335
"output_token": "NextToken",

‎services/costexplorer/src/main/resources/codegen-resources/service-2.json

Lines changed: 242 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -204,6 +204,22 @@
204204
],
205205
"documentation":"<p>Retrieves cost and usage metrics for your account. You can specify which cost and usage-related metric that you want the request to return. For example, you can specify <code>BlendedCosts</code> or <code>UsageQuantity</code>. You can also filter and group your data by various dimensions, such as <code>SERVICE</code> or <code>AZ</code>, in a specific time range. For a complete list of valid dimensions, see the <a href=\"https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetDimensionValues.html\">GetDimensionValues</a> operation. Management account in an organization in Organizations have access to all member accounts.</p> <p>For information about filter limitations, see <a href=\"https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-limits.html\">Quotas and restrictions</a> in the <i>Billing and Cost Management User Guide</i>.</p>"
206206
},
207+
"GetCostAndUsageComparisons":{
208+
"name":"GetCostAndUsageComparisons",
209+
"http":{
210+
"method":"POST",
211+
"requestUri":"/"
212+
},
213+
"input":{"shape":"GetCostAndUsageComparisonsRequest"},
214+
"output":{"shape":"GetCostAndUsageComparisonsResponse"},
215+
"errors":[
216+
{"shape":"DataUnavailableException"},
217+
{"shape":"InvalidNextTokenException"},
218+
{"shape":"LimitExceededException"},
219+
{"shape":"ResourceNotFoundException"}
220+
],
221+
"documentation":"<p>Retrieves cost and usage comparisons for your account between two periods within the last 13 months. If you have enabled multi-year data at monthly granularity, you can go back up to 38 months.</p>"
222+
},
207223
"GetCostAndUsageWithResources":{
208224
"name":"GetCostAndUsageWithResources",
209225
"http":{
@@ -240,6 +256,22 @@
240256
],
241257
"documentation":"<p>Retrieves an array of Cost Category names and values incurred cost.</p> <note> <p>If some Cost Category names and values are not associated with any cost, they will not be returned by this API.</p> </note>"
242258
},
259+
"GetCostComparisonDrivers":{
260+
"name":"GetCostComparisonDrivers",
261+
"http":{
262+
"method":"POST",
263+
"requestUri":"/"
264+
},
265+
"input":{"shape":"GetCostComparisonDriversRequest"},
266+
"output":{"shape":"GetCostComparisonDriversResponse"},
267+
"errors":[
268+
{"shape":"DataUnavailableException"},
269+
{"shape":"InvalidNextTokenException"},
270+
{"shape":"LimitExceededException"},
271+
{"shape":"ResourceNotFoundException"}
272+
],
273+
"documentation":"<p>Retrieves key factors driving cost changes between two time periods within the last 13 months, such as usage changes, discount changes, and commitment-based savings. If you have enabled multi-year data at monthly granularity, you can go back up to 38 months.</p>"
274+
},
243275
"GetCostForecast":{
244276
"name":"GetCostForecast",
245277
"http":{
@@ -1023,6 +1055,33 @@
10231055
},
10241056
"documentation":"<p>The configuration for the commitment purchase analysis.</p>"
10251057
},
1058+
"ComparisonMetricValue":{
1059+
"type":"structure",
1060+
"members":{
1061+
"BaselineTimePeriodAmount":{
1062+
"shape":"GenericString",
1063+
"documentation":"<p>The numeric value for the baseline time period measurement.</p>"
1064+
},
1065+
"ComparisonTimePeriodAmount":{
1066+
"shape":"GenericString",
1067+
"documentation":"<p>The numeric value for the comparison time period measurement.</p>"
1068+
},
1069+
"Difference":{
1070+
"shape":"GenericString",
1071+
"documentation":"<p>The calculated difference between <code>ComparisonTimePeriodAmount</code> and <code>BaselineTimePeriodAmount</code>.</p>"
1072+
},
1073+
"Unit":{
1074+
"shape":"GenericString",
1075+
"documentation":"<p>The unit of measurement applicable to all numeric values in this comparison.</p>"
1076+
}
1077+
},
1078+
"documentation":"<p>Contains cost or usage metric values for comparing two time periods. Each value includes amounts for the baseline and comparison time periods, their difference, and the unit of measurement.</p>"
1079+
},
1080+
"ComparisonMetrics":{
1081+
"type":"map",
1082+
"key":{"shape":"MetricName"},
1083+
"value":{"shape":"ComparisonMetricValue"}
1084+
},
10261085
"Context":{
10271086
"type":"string",
10281087
"enum":[
@@ -1157,6 +1216,27 @@
11571216
"max":1000,
11581217
"min":1
11591218
},
1219+
"CostAndUsageComparison":{
1220+
"type":"structure",
1221+
"members":{
1222+
"CostAndUsageSelector":{"shape":"Expression"},
1223+
"Metrics":{
1224+
"shape":"ComparisonMetrics",
1225+
"documentation":"<p>A mapping of metric names to their comparison values.</p>"
1226+
}
1227+
},
1228+
"documentation":"<p>Represents a comparison of cost and usage metrics between two time periods.</p>"
1229+
},
1230+
"CostAndUsageComparisons":{
1231+
"type":"list",
1232+
"member":{"shape":"CostAndUsageComparison"}
1233+
},
1234+
"CostAndUsageComparisonsMaxResults":{
1235+
"type":"integer",
1236+
"box":true,
1237+
"max":2000,
1238+
"min":1
1239+
},
11601240
"CostCategory":{
11611241
"type":"structure",
11621242
"required":[
@@ -1443,6 +1523,53 @@
14431523
"type":"list",
14441524
"member":{"shape":"CostCategoryValue"}
14451525
},
1526+
"CostComparisonDriver":{
1527+
"type":"structure",
1528+
"members":{
1529+
"CostSelector":{"shape":"Expression"},
1530+
"Metrics":{
1531+
"shape":"ComparisonMetrics",
1532+
"documentation":"<p>A mapping of metric names to their comparison values.</p>"
1533+
},
1534+
"CostDrivers":{
1535+
"shape":"CostDrivers",
1536+
"documentation":"<p>An array of cost drivers, each representing a cost difference between the baseline and comparison time periods. Each entry also includes a metric delta (for example, usage change) that contributed to the cost variance, along with the identifier and type of change.</p>"
1537+
}
1538+
},
1539+
"documentation":"<p>Represents a collection of cost drivers and their associated metrics for cost comparison analysis.</p>"
1540+
},
1541+
"CostComparisonDrivers":{
1542+
"type":"list",
1543+
"member":{"shape":"CostComparisonDriver"}
1544+
},
1545+
"CostComparisonDriversMaxResults":{
1546+
"type":"integer",
1547+
"box":true,
1548+
"max":10,
1549+
"min":1
1550+
},
1551+
"CostDriver":{
1552+
"type":"structure",
1553+
"members":{
1554+
"Type":{
1555+
"shape":"GenericString",
1556+
"documentation":"<p>The category or classification of the cost driver.</p> <p>Values include: BUNDLED_DISCOUNT, CREDIT, OUT_OF_CYCLE_CHARGE, REFUND, RECURRING_RESERVATION_FEE, RESERVATION_USAGE, RI_VOLUME_DISCOUNT, SAVINGS_PLAN_USAGE, SAVINGS_PLAN_NEGATION, SAVINGS_PLAN_RECURRING_FEE, SUPPORT_FEE, TAX, UPFRONT_RESERVATION_FEE, USAGE_CHANGE, COMMITMENT</p>"
1557+
},
1558+
"Name":{
1559+
"shape":"GenericString",
1560+
"documentation":"<p>The specific identifier of the cost driver.</p>"
1561+
},
1562+
"Metrics":{
1563+
"shape":"ComparisonMetrics",
1564+
"documentation":"<p>A mapping of metric names to their comparison values, measuring the impact of this cost driver.</p>"
1565+
}
1566+
},
1567+
"documentation":"<p>Represents factors that contribute to cost variations between the baseline and comparison time periods, including the type of driver, an identifier of the driver, and associated metrics.</p>"
1568+
},
1569+
"CostDrivers":{
1570+
"type":"list",
1571+
"member":{"shape":"CostDriver"}
1572+
},
14461573
"Coverage":{
14471574
"type":"structure",
14481575
"members":{
@@ -1717,8 +1844,7 @@
17171844
},
17181845
"DeleteAnomalyMonitorResponse":{
17191846
"type":"structure",
1720-
"members":{
1721-
}
1847+
"members":{}
17221848
},
17231849
"DeleteAnomalySubscriptionRequest":{
17241850
"type":"structure",
@@ -1732,8 +1858,7 @@
17321858
},
17331859
"DeleteAnomalySubscriptionResponse":{
17341860
"type":"structure",
1735-
"members":{
1736-
}
1861+
"members":{}
17371862
},
17381863
"DeleteCostCategoryDefinitionRequest":{
17391864
"type":"structure",
@@ -2444,6 +2569,63 @@
24442569
}
24452570
}
24462571
},
2572+
"GetCostAndUsageComparisonsRequest":{
2573+
"type":"structure",
2574+
"required":[
2575+
"BaselineTimePeriod",
2576+
"ComparisonTimePeriod",
2577+
"MetricForComparison"
2578+
],
2579+
"members":{
2580+
"BillingViewArn":{
2581+
"shape":"BillingViewArn",
2582+
"documentation":"<p>The Amazon Resource Name (ARN) that uniquely identifies a specific billing view. The ARN is used to specify which particular billing view you want to interact with or retrieve information from when making API calls related to Amazon Web Services Billing and Cost Management features. The BillingViewArn can be retrieved by calling the ListBillingViews API.</p>"
2583+
},
2584+
"BaselineTimePeriod":{
2585+
"shape":"DateInterval",
2586+
"documentation":"<p>The reference time period for comparison. This time period serves as the baseline against which other cost and usage data will be compared. The interval must start and end on the first day of a month, with a duration of exactly one month.</p>"
2587+
},
2588+
"ComparisonTimePeriod":{
2589+
"shape":"DateInterval",
2590+
"documentation":"<p>The comparison time period for analysis. This time period's cost and usage data will be compared against the baseline time period. The interval must start and end on the first day of a month, with a duration of exactly one month.</p>"
2591+
},
2592+
"MetricForComparison":{
2593+
"shape":"MetricName",
2594+
"documentation":"<p>The cost and usage metric to compare. Valid values are <code>AmortizedCost</code>, <code>BlendedCost</code>, <code>NetAmortizedCost</code>, <code>NetUnblendedCost</code>, <code>NormalizedUsageAmount</code>, <code>UnblendedCost</code>, and <code>UsageQuantity</code>.</p>"
2595+
},
2596+
"Filter":{"shape":"Expression"},
2597+
"GroupBy":{
2598+
"shape":"GroupDefinitions",
2599+
"documentation":"<p>You can group results using the attributes <code>DIMENSION</code>, <code>TAG</code>, and <code>COST_CATEGORY</code>. </p>"
2600+
},
2601+
"MaxResults":{
2602+
"shape":"CostAndUsageComparisonsMaxResults",
2603+
"documentation":"<p>The maximum number of results that are returned for the request.</p>",
2604+
"box":true
2605+
},
2606+
"NextPageToken":{
2607+
"shape":"NextPageToken",
2608+
"documentation":"<p>The token to retrieve the next set of paginated results.</p>"
2609+
}
2610+
}
2611+
},
2612+
"GetCostAndUsageComparisonsResponse":{
2613+
"type":"structure",
2614+
"members":{
2615+
"CostAndUsageComparisons":{
2616+
"shape":"CostAndUsageComparisons",
2617+
"documentation":"<p>An array of comparison results showing cost and usage metrics between <code>BaselineTimePeriod</code> and <code>ComparisonTimePeriod</code>.</p>"
2618+
},
2619+
"TotalCostAndUsage":{
2620+
"shape":"ComparisonMetrics",
2621+
"documentation":"<p>A summary of the total cost and usage, comparing amounts between <code>BaselineTimePeriod</code> and <code>ComparisonTimePeriod</code> and their differences. This total represents the aggregate total across all paginated results, if the response spans multiple pages.</p>"
2622+
},
2623+
"NextPageToken":{
2624+
"shape":"NextPageToken",
2625+
"documentation":"<p>The token to retrieve the next set of paginated results.</p>"
2626+
}
2627+
}
2628+
},
24472629
"GetCostAndUsageRequest":{
24482630
"type":"structure",
24492631
"required":[
@@ -2620,6 +2802,59 @@
26202802
}
26212803
}
26222804
},
2805+
"GetCostComparisonDriversRequest":{
2806+
"type":"structure",
2807+
"required":[
2808+
"BaselineTimePeriod",
2809+
"ComparisonTimePeriod",
2810+
"MetricForComparison"
2811+
],
2812+
"members":{
2813+
"BillingViewArn":{
2814+
"shape":"BillingViewArn",
2815+
"documentation":"<p>The Amazon Resource Name (ARN) that uniquely identifies a specific billing view. The ARN is used to specify which particular billing view you want to interact with or retrieve information from when making API calls related to Amazon Web Services Billing and Cost Management features. The BillingViewArn can be retrieved by calling the ListBillingViews API.</p>"
2816+
},
2817+
"BaselineTimePeriod":{
2818+
"shape":"DateInterval",
2819+
"documentation":"<p>The reference time period for comparison. This time period serves as the baseline against which other cost and usage data will be compared. The interval must start and end on the first day of a month, with a duration of exactly one month.</p>"
2820+
},
2821+
"ComparisonTimePeriod":{
2822+
"shape":"DateInterval",
2823+
"documentation":"<p>The comparison time period for analysis. This time period's cost and usage data will be compared against the baseline time period. The interval must start and end on the first day of a month, with a duration of exactly one month.</p>"
2824+
},
2825+
"MetricForComparison":{
2826+
"shape":"MetricName",
2827+
"documentation":"<p>The cost and usage metric to compare. Valid values are <code>AmortizedCost</code>, <code>BlendedCost</code>, <code>NetAmortizedCost</code>, <code>NetUnblendedCost</code>, <code>NormalizedUsageAmount</code>, <code>UnblendedCost</code>, and <code>UsageQuantity</code>.</p>"
2828+
},
2829+
"Filter":{"shape":"Expression"},
2830+
"GroupBy":{
2831+
"shape":"GroupDefinitions",
2832+
"documentation":"<p>You can group results using the attributes <code>DIMENSION</code>, <code>TAG</code>, and <code>COST_CATEGORY</code>. Note that <code>SERVICE</code> and <code>USAGE_TYPE</code> dimensions are automatically included in the cost comparison drivers analysis.</p>"
2833+
},
2834+
"MaxResults":{
2835+
"shape":"CostComparisonDriversMaxResults",
2836+
"documentation":"<p>The maximum number of results that are returned for the request.</p>",
2837+
"box":true
2838+
},
2839+
"NextPageToken":{
2840+
"shape":"NextPageToken",
2841+
"documentation":"<p>The token to retrieve the next set of paginated results.</p>"
2842+
}
2843+
}
2844+
},
2845+
"GetCostComparisonDriversResponse":{
2846+
"type":"structure",
2847+
"members":{
2848+
"CostComparisonDrivers":{
2849+
"shape":"CostComparisonDrivers",
2850+
"documentation":"<p>An array of comparison results showing factors that drive significant cost differences between <code>BaselineTimePeriod</code> and <code>ComparisonTimePeriod</code>.</p>"
2851+
},
2852+
"NextPageToken":{
2853+
"shape":"NextPageToken",
2854+
"documentation":"<p>The token to retrieve the next set of paginated results.</p>"
2855+
}
2856+
}
2857+
},
26232858
"GetCostForecastRequest":{
26242859
"type":"structure",
26252860
"required":[
@@ -5332,8 +5567,7 @@
53325567
},
53335568
"StartSavingsPlansPurchaseRecommendationGenerationRequest":{
53345569
"type":"structure",
5335-
"members":{
5336-
}
5570+
"members":{}
53375571
},
53385572
"StartSavingsPlansPurchaseRecommendationGenerationResponse":{
53395573
"type":"structure",
@@ -5431,8 +5665,7 @@
54315665
},
54325666
"TagResourceResponse":{
54335667
"type":"structure",
5434-
"members":{
5435-
}
5668+
"members":{}
54365669
},
54375670
"TagValues":{
54385671
"type":"structure",
@@ -5596,8 +5829,7 @@
55965829
},
55975830
"UntagResourceResponse":{
55985831
"type":"structure",
5599-
"members":{
5600-
}
5832+
"members":{}
56015833
},
56025834
"UnusedHours":{"type":"string"},
56035835
"UnusedUnits":{"type":"string"},

0 commit comments

Comments
 (0)