aws-sdk-costexplorer 1.33.0 → 1.34.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/aws-sdk-costexplorer.rb +1 -1
- data/lib/aws-sdk-costexplorer/client.rb +361 -8
- data/lib/aws-sdk-costexplorer/client_api.rb +146 -0
- data/lib/aws-sdk-costexplorer/errors.rb +32 -0
- data/lib/aws-sdk-costexplorer/types.rb +570 -7
- metadata +2 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 20066af8625919a4d4a33c62ade6c6a3ee5ca7cd
|
|
4
|
+
data.tar.gz: '06187ed864f2cdf854f550a9a61d90eedae5d808'
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 9c3d049527b80f7e20e3c8b932f8da7b14fe36a796ece9734b53cd8fdd0b8a20c6dae78f01bca34e11fefebf6375fae11b996cff50956f621160956b2785f52a
|
|
7
|
+
data.tar.gz: '0693fd2ddda6730666834f99f699991e1fe339c7c8532dc4e39165d2d1cbbdc40dfdefdc19a7b1278e776cc540329a28b1e453cdb4fd13ac94e4cd2e5a92ed29'
|
data/lib/aws-sdk-costexplorer.rb
CHANGED
|
@@ -264,6 +264,185 @@ module Aws::CostExplorer
|
|
|
264
264
|
|
|
265
265
|
# @!group API Operations
|
|
266
266
|
|
|
267
|
+
# <i> <b>Cost Category is in preview release for AWS Billing and Cost
|
|
268
|
+
# Management and is subject to change. Your use of Cost Categories is
|
|
269
|
+
# subject to the Beta Service Participation terms of the <a
|
|
270
|
+
# href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
|
|
271
|
+
# (Section 1.10).</b> </i>
|
|
272
|
+
#
|
|
273
|
+
# Creates a new Cost Category with the requested name and rules.
|
|
274
|
+
#
|
|
275
|
+
# @option params [required, String] :name
|
|
276
|
+
# The unique name of the Cost Category.
|
|
277
|
+
#
|
|
278
|
+
# @option params [required, String] :rule_version
|
|
279
|
+
# The rule schema version in this particular Cost Category.
|
|
280
|
+
#
|
|
281
|
+
# @option params [required, Array<Types::CostCategoryRule>] :rules
|
|
282
|
+
# Rules are processed in order. If there are multiple rules that match
|
|
283
|
+
# the line item, then the first rule to match is used to determine that
|
|
284
|
+
# Cost Category value.
|
|
285
|
+
#
|
|
286
|
+
# @return [Types::CreateCostCategoryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
287
|
+
#
|
|
288
|
+
# * {Types::CreateCostCategoryDefinitionResponse#cost_category_arn #cost_category_arn} => String
|
|
289
|
+
# * {Types::CreateCostCategoryDefinitionResponse#effective_start #effective_start} => String
|
|
290
|
+
#
|
|
291
|
+
# @example Request syntax with placeholder values
|
|
292
|
+
#
|
|
293
|
+
# resp = client.create_cost_category_definition({
|
|
294
|
+
# name: "CostCategoryName", # required
|
|
295
|
+
# rule_version: "CostCategoryExpression.v1", # required, accepts CostCategoryExpression.v1
|
|
296
|
+
# rules: [ # required
|
|
297
|
+
# {
|
|
298
|
+
# value: "CostCategoryValue", # required
|
|
299
|
+
# rule: { # required
|
|
300
|
+
# or: [
|
|
301
|
+
# {
|
|
302
|
+
# # recursive Expression
|
|
303
|
+
# },
|
|
304
|
+
# ],
|
|
305
|
+
# and: [
|
|
306
|
+
# {
|
|
307
|
+
# # recursive Expression
|
|
308
|
+
# },
|
|
309
|
+
# ],
|
|
310
|
+
# not: {
|
|
311
|
+
# # recursive Expression
|
|
312
|
+
# },
|
|
313
|
+
# dimensions: {
|
|
314
|
+
# key: "AZ", # accepts 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, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
|
|
315
|
+
# values: ["Value"],
|
|
316
|
+
# },
|
|
317
|
+
# tags: {
|
|
318
|
+
# key: "TagKey",
|
|
319
|
+
# values: ["Value"],
|
|
320
|
+
# },
|
|
321
|
+
# cost_categories: {
|
|
322
|
+
# key: "CostCategoryName",
|
|
323
|
+
# values: ["Value"],
|
|
324
|
+
# },
|
|
325
|
+
# },
|
|
326
|
+
# },
|
|
327
|
+
# ],
|
|
328
|
+
# })
|
|
329
|
+
#
|
|
330
|
+
# @example Response structure
|
|
331
|
+
#
|
|
332
|
+
# resp.cost_category_arn #=> String
|
|
333
|
+
# resp.effective_start #=> String
|
|
334
|
+
#
|
|
335
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CreateCostCategoryDefinition AWS API Documentation
|
|
336
|
+
#
|
|
337
|
+
# @overload create_cost_category_definition(params = {})
|
|
338
|
+
# @param [Hash] params ({})
|
|
339
|
+
def create_cost_category_definition(params = {}, options = {})
|
|
340
|
+
req = build_request(:create_cost_category_definition, params)
|
|
341
|
+
req.send_request(options)
|
|
342
|
+
end
|
|
343
|
+
|
|
344
|
+
# <i> <b>Cost Category is in preview release for AWS Billing and Cost
|
|
345
|
+
# Management and is subject to change. Your use of Cost Categories is
|
|
346
|
+
# subject to the Beta Service Participation terms of the <a
|
|
347
|
+
# href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
|
|
348
|
+
# (Section 1.10).</b> </i>
|
|
349
|
+
#
|
|
350
|
+
# Deletes a Cost Category. Expenses from this month going forward will
|
|
351
|
+
# no longer be categorized with this Cost Category.
|
|
352
|
+
#
|
|
353
|
+
# @option params [required, String] :cost_category_arn
|
|
354
|
+
# The unique identifier for your Cost Category.
|
|
355
|
+
#
|
|
356
|
+
# @return [Types::DeleteCostCategoryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
357
|
+
#
|
|
358
|
+
# * {Types::DeleteCostCategoryDefinitionResponse#cost_category_arn #cost_category_arn} => String
|
|
359
|
+
# * {Types::DeleteCostCategoryDefinitionResponse#effective_end #effective_end} => String
|
|
360
|
+
#
|
|
361
|
+
# @example Request syntax with placeholder values
|
|
362
|
+
#
|
|
363
|
+
# resp = client.delete_cost_category_definition({
|
|
364
|
+
# cost_category_arn: "Arn", # required
|
|
365
|
+
# })
|
|
366
|
+
#
|
|
367
|
+
# @example Response structure
|
|
368
|
+
#
|
|
369
|
+
# resp.cost_category_arn #=> String
|
|
370
|
+
# resp.effective_end #=> String
|
|
371
|
+
#
|
|
372
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/DeleteCostCategoryDefinition AWS API Documentation
|
|
373
|
+
#
|
|
374
|
+
# @overload delete_cost_category_definition(params = {})
|
|
375
|
+
# @param [Hash] params ({})
|
|
376
|
+
def delete_cost_category_definition(params = {}, options = {})
|
|
377
|
+
req = build_request(:delete_cost_category_definition, params)
|
|
378
|
+
req.send_request(options)
|
|
379
|
+
end
|
|
380
|
+
|
|
381
|
+
# <i> <b>Cost Category is in preview release for AWS Billing and Cost
|
|
382
|
+
# Management and is subject to change. Your use of Cost Categories is
|
|
383
|
+
# subject to the Beta Service Participation terms of the <a
|
|
384
|
+
# href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
|
|
385
|
+
# (Section 1.10).</b> </i>
|
|
386
|
+
#
|
|
387
|
+
# Returns the name, ARN, rules, definition, and effective dates of a
|
|
388
|
+
# Cost Category that's defined in the account.
|
|
389
|
+
#
|
|
390
|
+
# You have the option to use `EffectiveOn` to return a Cost Category
|
|
391
|
+
# that is active on a specific date. If there is no `EffectiveOn`
|
|
392
|
+
# specified, you’ll see a Cost Category that is effective on the current
|
|
393
|
+
# date. If Cost Category is still effective, `EffectiveEnd` is omitted
|
|
394
|
+
# in the response.
|
|
395
|
+
#
|
|
396
|
+
# @option params [required, String] :cost_category_arn
|
|
397
|
+
# The unique identifier for your Cost Category.
|
|
398
|
+
#
|
|
399
|
+
# @option params [String] :effective_on
|
|
400
|
+
# The date when the Cost Category was effective.
|
|
401
|
+
#
|
|
402
|
+
# @return [Types::DescribeCostCategoryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
403
|
+
#
|
|
404
|
+
# * {Types::DescribeCostCategoryDefinitionResponse#cost_category #cost_category} => Types::CostCategory
|
|
405
|
+
#
|
|
406
|
+
# @example Request syntax with placeholder values
|
|
407
|
+
#
|
|
408
|
+
# resp = client.describe_cost_category_definition({
|
|
409
|
+
# cost_category_arn: "Arn", # required
|
|
410
|
+
# effective_on: "ZonedDateTime",
|
|
411
|
+
# })
|
|
412
|
+
#
|
|
413
|
+
# @example Response structure
|
|
414
|
+
#
|
|
415
|
+
# resp.cost_category.cost_category_arn #=> String
|
|
416
|
+
# resp.cost_category.effective_start #=> String
|
|
417
|
+
# resp.cost_category.effective_end #=> String
|
|
418
|
+
# resp.cost_category.name #=> String
|
|
419
|
+
# resp.cost_category.rule_version #=> String, one of "CostCategoryExpression.v1"
|
|
420
|
+
# resp.cost_category.rules #=> Array
|
|
421
|
+
# resp.cost_category.rules[0].value #=> String
|
|
422
|
+
# resp.cost_category.rules[0].rule.or #=> Array
|
|
423
|
+
# resp.cost_category.rules[0].rule.or[0] #=> Types::Expression
|
|
424
|
+
# resp.cost_category.rules[0].rule.and #=> Array
|
|
425
|
+
# resp.cost_category.rules[0].rule.and[0] #=> Types::Expression
|
|
426
|
+
# resp.cost_category.rules[0].rule.not #=> Types::Expression
|
|
427
|
+
# resp.cost_category.rules[0].rule.dimensions.key #=> String, one of "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", "CACHE_ENGINE", "INSTANCE_TYPE_FAMILY", "BILLING_ENTITY", "RESERVATION_ID", "RESOURCE_ID", "RIGHTSIZING_TYPE", "SAVINGS_PLANS_TYPE", "SAVINGS_PLAN_ARN", "PAYMENT_OPTION"
|
|
428
|
+
# resp.cost_category.rules[0].rule.dimensions.values #=> Array
|
|
429
|
+
# resp.cost_category.rules[0].rule.dimensions.values[0] #=> String
|
|
430
|
+
# resp.cost_category.rules[0].rule.tags.key #=> String
|
|
431
|
+
# resp.cost_category.rules[0].rule.tags.values #=> Array
|
|
432
|
+
# resp.cost_category.rules[0].rule.tags.values[0] #=> String
|
|
433
|
+
# resp.cost_category.rules[0].rule.cost_categories.key #=> String
|
|
434
|
+
# resp.cost_category.rules[0].rule.cost_categories.values #=> Array
|
|
435
|
+
# resp.cost_category.rules[0].rule.cost_categories.values[0] #=> String
|
|
436
|
+
#
|
|
437
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/DescribeCostCategoryDefinition AWS API Documentation
|
|
438
|
+
#
|
|
439
|
+
# @overload describe_cost_category_definition(params = {})
|
|
440
|
+
# @param [Hash] params ({})
|
|
441
|
+
def describe_cost_category_definition(params = {}, options = {})
|
|
442
|
+
req = build_request(:describe_cost_category_definition, params)
|
|
443
|
+
req.send_request(options)
|
|
444
|
+
end
|
|
445
|
+
|
|
267
446
|
# Retrieves cost and usage metrics for your account. You can specify
|
|
268
447
|
# which cost and usage-related metric, such as `BlendedCosts` or
|
|
269
448
|
# `UsageQuantity`, that you want the request to return. You can also
|
|
@@ -377,11 +556,15 @@ module Aws::CostExplorer
|
|
|
377
556
|
# key: "TagKey",
|
|
378
557
|
# values: ["Value"],
|
|
379
558
|
# },
|
|
559
|
+
# cost_categories: {
|
|
560
|
+
# key: "CostCategoryName",
|
|
561
|
+
# values: ["Value"],
|
|
562
|
+
# },
|
|
380
563
|
# },
|
|
381
564
|
# metrics: ["MetricName"],
|
|
382
565
|
# group_by: [
|
|
383
566
|
# {
|
|
384
|
-
# type: "DIMENSION", # accepts DIMENSION, TAG
|
|
567
|
+
# type: "DIMENSION", # accepts DIMENSION, TAG, COST_CATEGORY
|
|
385
568
|
# key: "GroupDefinitionKey",
|
|
386
569
|
# },
|
|
387
570
|
# ],
|
|
@@ -392,7 +575,7 @@ module Aws::CostExplorer
|
|
|
392
575
|
#
|
|
393
576
|
# resp.next_page_token #=> String
|
|
394
577
|
# resp.group_definitions #=> Array
|
|
395
|
-
# resp.group_definitions[0].type #=> String, one of "DIMENSION", "TAG"
|
|
578
|
+
# resp.group_definitions[0].type #=> String, one of "DIMENSION", "TAG", "COST_CATEGORY"
|
|
396
579
|
# resp.group_definitions[0].key #=> String
|
|
397
580
|
# resp.results_by_time #=> Array
|
|
398
581
|
# resp.results_by_time[0].time_period.start #=> String
|
|
@@ -537,11 +720,15 @@ module Aws::CostExplorer
|
|
|
537
720
|
# key: "TagKey",
|
|
538
721
|
# values: ["Value"],
|
|
539
722
|
# },
|
|
723
|
+
# cost_categories: {
|
|
724
|
+
# key: "CostCategoryName",
|
|
725
|
+
# values: ["Value"],
|
|
726
|
+
# },
|
|
540
727
|
# },
|
|
541
728
|
# metrics: ["MetricName"],
|
|
542
729
|
# group_by: [
|
|
543
730
|
# {
|
|
544
|
-
# type: "DIMENSION", # accepts DIMENSION, TAG
|
|
731
|
+
# type: "DIMENSION", # accepts DIMENSION, TAG, COST_CATEGORY
|
|
545
732
|
# key: "GroupDefinitionKey",
|
|
546
733
|
# },
|
|
547
734
|
# ],
|
|
@@ -552,7 +739,7 @@ module Aws::CostExplorer
|
|
|
552
739
|
#
|
|
553
740
|
# resp.next_page_token #=> String
|
|
554
741
|
# resp.group_definitions #=> Array
|
|
555
|
-
# resp.group_definitions[0].type #=> String, one of "DIMENSION", "TAG"
|
|
742
|
+
# resp.group_definitions[0].type #=> String, one of "DIMENSION", "TAG", "COST_CATEGORY"
|
|
556
743
|
# resp.group_definitions[0].key #=> String
|
|
557
744
|
# resp.results_by_time #=> Array
|
|
558
745
|
# resp.results_by_time[0].time_period.start #=> String
|
|
@@ -660,6 +847,10 @@ module Aws::CostExplorer
|
|
|
660
847
|
# key: "TagKey",
|
|
661
848
|
# values: ["Value"],
|
|
662
849
|
# },
|
|
850
|
+
# cost_categories: {
|
|
851
|
+
# key: "CostCategoryName",
|
|
852
|
+
# values: ["Value"],
|
|
853
|
+
# },
|
|
663
854
|
# },
|
|
664
855
|
# prediction_interval_level: 1,
|
|
665
856
|
# })
|
|
@@ -998,7 +1189,7 @@ module Aws::CostExplorer
|
|
|
998
1189
|
# },
|
|
999
1190
|
# group_by: [
|
|
1000
1191
|
# {
|
|
1001
|
-
# type: "DIMENSION", # accepts DIMENSION, TAG
|
|
1192
|
+
# type: "DIMENSION", # accepts DIMENSION, TAG, COST_CATEGORY
|
|
1002
1193
|
# key: "GroupDefinitionKey",
|
|
1003
1194
|
# },
|
|
1004
1195
|
# ],
|
|
@@ -1025,6 +1216,10 @@ module Aws::CostExplorer
|
|
|
1025
1216
|
# key: "TagKey",
|
|
1026
1217
|
# values: ["Value"],
|
|
1027
1218
|
# },
|
|
1219
|
+
# cost_categories: {
|
|
1220
|
+
# key: "CostCategoryName",
|
|
1221
|
+
# values: ["Value"],
|
|
1222
|
+
# },
|
|
1028
1223
|
# },
|
|
1029
1224
|
# metrics: ["MetricName"],
|
|
1030
1225
|
# next_page_token: "NextPageToken",
|
|
@@ -1316,7 +1511,7 @@ module Aws::CostExplorer
|
|
|
1316
1511
|
# },
|
|
1317
1512
|
# group_by: [
|
|
1318
1513
|
# {
|
|
1319
|
-
# type: "DIMENSION", # accepts DIMENSION, TAG
|
|
1514
|
+
# type: "DIMENSION", # accepts DIMENSION, TAG, COST_CATEGORY
|
|
1320
1515
|
# key: "GroupDefinitionKey",
|
|
1321
1516
|
# },
|
|
1322
1517
|
# ],
|
|
@@ -1343,6 +1538,10 @@ module Aws::CostExplorer
|
|
|
1343
1538
|
# key: "TagKey",
|
|
1344
1539
|
# values: ["Value"],
|
|
1345
1540
|
# },
|
|
1541
|
+
# cost_categories: {
|
|
1542
|
+
# key: "CostCategoryName",
|
|
1543
|
+
# values: ["Value"],
|
|
1544
|
+
# },
|
|
1346
1545
|
# },
|
|
1347
1546
|
# next_page_token: "NextPageToken",
|
|
1348
1547
|
# })
|
|
@@ -1512,6 +1711,10 @@ module Aws::CostExplorer
|
|
|
1512
1711
|
# key: "TagKey",
|
|
1513
1712
|
# values: ["Value"],
|
|
1514
1713
|
# },
|
|
1714
|
+
# cost_categories: {
|
|
1715
|
+
# key: "CostCategoryName",
|
|
1716
|
+
# values: ["Value"],
|
|
1717
|
+
# },
|
|
1515
1718
|
# },
|
|
1516
1719
|
# service: "GenericString", # required
|
|
1517
1720
|
# page_size: 1,
|
|
@@ -1664,7 +1867,7 @@ module Aws::CostExplorer
|
|
|
1664
1867
|
# },
|
|
1665
1868
|
# group_by: [
|
|
1666
1869
|
# {
|
|
1667
|
-
# type: "DIMENSION", # accepts DIMENSION, TAG
|
|
1870
|
+
# type: "DIMENSION", # accepts DIMENSION, TAG, COST_CATEGORY
|
|
1668
1871
|
# key: "GroupDefinitionKey",
|
|
1669
1872
|
# },
|
|
1670
1873
|
# ],
|
|
@@ -1691,6 +1894,10 @@ module Aws::CostExplorer
|
|
|
1691
1894
|
# key: "TagKey",
|
|
1692
1895
|
# values: ["Value"],
|
|
1693
1896
|
# },
|
|
1897
|
+
# cost_categories: {
|
|
1898
|
+
# key: "CostCategoryName",
|
|
1899
|
+
# values: ["Value"],
|
|
1900
|
+
# },
|
|
1694
1901
|
# },
|
|
1695
1902
|
# metrics: ["MetricName"],
|
|
1696
1903
|
# next_token: "NextPageToken",
|
|
@@ -1893,6 +2100,10 @@ module Aws::CostExplorer
|
|
|
1893
2100
|
# key: "TagKey",
|
|
1894
2101
|
# values: ["Value"],
|
|
1895
2102
|
# },
|
|
2103
|
+
# cost_categories: {
|
|
2104
|
+
# key: "CostCategoryName",
|
|
2105
|
+
# values: ["Value"],
|
|
2106
|
+
# },
|
|
1896
2107
|
# },
|
|
1897
2108
|
# })
|
|
1898
2109
|
#
|
|
@@ -2016,6 +2227,10 @@ module Aws::CostExplorer
|
|
|
2016
2227
|
# key: "TagKey",
|
|
2017
2228
|
# values: ["Value"],
|
|
2018
2229
|
# },
|
|
2230
|
+
# cost_categories: {
|
|
2231
|
+
# key: "CostCategoryName",
|
|
2232
|
+
# values: ["Value"],
|
|
2233
|
+
# },
|
|
2019
2234
|
# },
|
|
2020
2235
|
# next_token: "NextPageToken",
|
|
2021
2236
|
# max_results: 1,
|
|
@@ -2191,6 +2406,10 @@ module Aws::CostExplorer
|
|
|
2191
2406
|
# key: "TagKey",
|
|
2192
2407
|
# values: ["Value"],
|
|
2193
2408
|
# },
|
|
2409
|
+
# cost_categories: {
|
|
2410
|
+
# key: "CostCategoryName",
|
|
2411
|
+
# values: ["Value"],
|
|
2412
|
+
# },
|
|
2194
2413
|
# },
|
|
2195
2414
|
# prediction_interval_level: 1,
|
|
2196
2415
|
# })
|
|
@@ -2215,6 +2434,140 @@ module Aws::CostExplorer
|
|
|
2215
2434
|
req.send_request(options)
|
|
2216
2435
|
end
|
|
2217
2436
|
|
|
2437
|
+
# <i> <b>Cost Category is in preview release for AWS Billing and Cost
|
|
2438
|
+
# Management and is subject to change. Your use of Cost Categories is
|
|
2439
|
+
# subject to the Beta Service Participation terms of the <a
|
|
2440
|
+
# href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
|
|
2441
|
+
# (Section 1.10).</b> </i>
|
|
2442
|
+
#
|
|
2443
|
+
# Returns the name, ARN and effective dates of all Cost Categories
|
|
2444
|
+
# defined in the account. You have the option to use `EffectiveOn` to
|
|
2445
|
+
# return a list of Cost Categories that were active on a specific date.
|
|
2446
|
+
# If there is no `EffectiveOn` specified, you’ll see Cost Categories
|
|
2447
|
+
# that are effective on the current date. If Cost Category is still
|
|
2448
|
+
# effective, `EffectiveEnd` is omitted in the response.
|
|
2449
|
+
#
|
|
2450
|
+
# @option params [String] :effective_on
|
|
2451
|
+
# The date when the Cost Category was effective.
|
|
2452
|
+
#
|
|
2453
|
+
# @option params [String] :next_token
|
|
2454
|
+
# The token to retrieve the next set of results. Amazon Web Services
|
|
2455
|
+
# provides the token when the response from a previous call has more
|
|
2456
|
+
# results than the maximum page size.
|
|
2457
|
+
#
|
|
2458
|
+
# You can use this information to retrieve the full Cost Category
|
|
2459
|
+
# information using `DescribeCostCategory`.
|
|
2460
|
+
#
|
|
2461
|
+
# @return [Types::ListCostCategoryDefinitionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
2462
|
+
#
|
|
2463
|
+
# * {Types::ListCostCategoryDefinitionsResponse#cost_category_references #cost_category_references} => Array<Types::CostCategoryReference>
|
|
2464
|
+
# * {Types::ListCostCategoryDefinitionsResponse#next_token #next_token} => String
|
|
2465
|
+
#
|
|
2466
|
+
# @example Request syntax with placeholder values
|
|
2467
|
+
#
|
|
2468
|
+
# resp = client.list_cost_category_definitions({
|
|
2469
|
+
# effective_on: "ZonedDateTime",
|
|
2470
|
+
# next_token: "NextPageToken",
|
|
2471
|
+
# })
|
|
2472
|
+
#
|
|
2473
|
+
# @example Response structure
|
|
2474
|
+
#
|
|
2475
|
+
# resp.cost_category_references #=> Array
|
|
2476
|
+
# resp.cost_category_references[0].cost_category_arn #=> String
|
|
2477
|
+
# resp.cost_category_references[0].name #=> String
|
|
2478
|
+
# resp.cost_category_references[0].effective_start #=> String
|
|
2479
|
+
# resp.cost_category_references[0].effective_end #=> String
|
|
2480
|
+
# resp.next_token #=> String
|
|
2481
|
+
#
|
|
2482
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostCategoryDefinitions AWS API Documentation
|
|
2483
|
+
#
|
|
2484
|
+
# @overload list_cost_category_definitions(params = {})
|
|
2485
|
+
# @param [Hash] params ({})
|
|
2486
|
+
def list_cost_category_definitions(params = {}, options = {})
|
|
2487
|
+
req = build_request(:list_cost_category_definitions, params)
|
|
2488
|
+
req.send_request(options)
|
|
2489
|
+
end
|
|
2490
|
+
|
|
2491
|
+
# <i> <b>Cost Category is in preview release for AWS Billing and Cost
|
|
2492
|
+
# Management and is subject to change. Your use of Cost Categories is
|
|
2493
|
+
# subject to the Beta Service Participation terms of the <a
|
|
2494
|
+
# href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
|
|
2495
|
+
# (Section 1.10).</b> </i>
|
|
2496
|
+
#
|
|
2497
|
+
# Updates an existing Cost Category. Changes made to the Cost Category
|
|
2498
|
+
# rules will be used to categorize the current month’s expenses and
|
|
2499
|
+
# future expenses. This won’t change categorization for the previous
|
|
2500
|
+
# months.
|
|
2501
|
+
#
|
|
2502
|
+
# @option params [required, String] :cost_category_arn
|
|
2503
|
+
# The unique identifier for your Cost Category.
|
|
2504
|
+
#
|
|
2505
|
+
# @option params [required, String] :rule_version
|
|
2506
|
+
# The rule schema version in this particular Cost Category.
|
|
2507
|
+
#
|
|
2508
|
+
# @option params [required, Array<Types::CostCategoryRule>] :rules
|
|
2509
|
+
# Rules are processed in order. If there are multiple rules that match
|
|
2510
|
+
# the line item, then the first rule to match is used to determine that
|
|
2511
|
+
# Cost Category value.
|
|
2512
|
+
#
|
|
2513
|
+
# @return [Types::UpdateCostCategoryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
2514
|
+
#
|
|
2515
|
+
# * {Types::UpdateCostCategoryDefinitionResponse#cost_category_arn #cost_category_arn} => String
|
|
2516
|
+
# * {Types::UpdateCostCategoryDefinitionResponse#effective_start #effective_start} => String
|
|
2517
|
+
#
|
|
2518
|
+
# @example Request syntax with placeholder values
|
|
2519
|
+
#
|
|
2520
|
+
# resp = client.update_cost_category_definition({
|
|
2521
|
+
# cost_category_arn: "Arn", # required
|
|
2522
|
+
# rule_version: "CostCategoryExpression.v1", # required, accepts CostCategoryExpression.v1
|
|
2523
|
+
# rules: [ # required
|
|
2524
|
+
# {
|
|
2525
|
+
# value: "CostCategoryValue", # required
|
|
2526
|
+
# rule: { # required
|
|
2527
|
+
# or: [
|
|
2528
|
+
# {
|
|
2529
|
+
# # recursive Expression
|
|
2530
|
+
# },
|
|
2531
|
+
# ],
|
|
2532
|
+
# and: [
|
|
2533
|
+
# {
|
|
2534
|
+
# # recursive Expression
|
|
2535
|
+
# },
|
|
2536
|
+
# ],
|
|
2537
|
+
# not: {
|
|
2538
|
+
# # recursive Expression
|
|
2539
|
+
# },
|
|
2540
|
+
# dimensions: {
|
|
2541
|
+
# key: "AZ", # accepts 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, CACHE_ENGINE, INSTANCE_TYPE_FAMILY, BILLING_ENTITY, RESERVATION_ID, RESOURCE_ID, RIGHTSIZING_TYPE, SAVINGS_PLANS_TYPE, SAVINGS_PLAN_ARN, PAYMENT_OPTION
|
|
2542
|
+
# values: ["Value"],
|
|
2543
|
+
# },
|
|
2544
|
+
# tags: {
|
|
2545
|
+
# key: "TagKey",
|
|
2546
|
+
# values: ["Value"],
|
|
2547
|
+
# },
|
|
2548
|
+
# cost_categories: {
|
|
2549
|
+
# key: "CostCategoryName",
|
|
2550
|
+
# values: ["Value"],
|
|
2551
|
+
# },
|
|
2552
|
+
# },
|
|
2553
|
+
# },
|
|
2554
|
+
# ],
|
|
2555
|
+
# })
|
|
2556
|
+
#
|
|
2557
|
+
# @example Response structure
|
|
2558
|
+
#
|
|
2559
|
+
# resp.cost_category_arn #=> String
|
|
2560
|
+
# resp.effective_start #=> String
|
|
2561
|
+
#
|
|
2562
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/UpdateCostCategoryDefinition AWS API Documentation
|
|
2563
|
+
#
|
|
2564
|
+
# @overload update_cost_category_definition(params = {})
|
|
2565
|
+
# @param [Hash] params ({})
|
|
2566
|
+
def update_cost_category_definition(params = {}, options = {})
|
|
2567
|
+
req = build_request(:update_cost_category_definition, params)
|
|
2568
|
+
req.send_request(options)
|
|
2569
|
+
end
|
|
2570
|
+
|
|
2218
2571
|
# @!endgroup
|
|
2219
2572
|
|
|
2220
2573
|
# @param params ({})
|
|
@@ -2228,7 +2581,7 @@ module Aws::CostExplorer
|
|
|
2228
2581
|
params: params,
|
|
2229
2582
|
config: config)
|
|
2230
2583
|
context[:gem_name] = 'aws-sdk-costexplorer'
|
|
2231
|
-
context[:gem_version] = '1.
|
|
2584
|
+
context[:gem_version] = '1.34.0'
|
|
2232
2585
|
Seahorse::Client::Request.new(handlers, context)
|
|
2233
2586
|
end
|
|
2234
2587
|
|