aws-sdk-costexplorer 1.37.0 → 1.42.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 +168 -95
- data/lib/aws-sdk-costexplorer/client_api.rb +26 -0
- data/lib/aws-sdk-costexplorer/resource.rb +1 -7
- data/lib/aws-sdk-costexplorer/types.rb +258 -114
- metadata +4 -3
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 49897667ca86fa355c32fd2e31e574def48689717a011dbe92e9b77130d4299e
|
4
|
+
data.tar.gz: ebe36f0f6680f0215c669cac80da6fc4a9612c979619721814265f22c629cd6c
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 3529c9cb7f249daf2bd76991a66b553eb261afc451f102ac813029c362c7453a7e84ce8b2f8f459b41cfc5a479b0cfe6c131cdd73e2af33beb767b436b09adcd
|
7
|
+
data.tar.gz: 95a0e118299cdf27c4dcb9a8a285f9a313516f0a9ec0f07d01e66b8df0662d4138c5fbcd9100afdba43ab1e87c63cbf9653984e934cd3e651c8f54b94eeb325a
|
data/lib/aws-sdk-costexplorer.rb
CHANGED
@@ -105,7 +105,7 @@ module Aws::CostExplorer
|
|
105
105
|
# @option options [required, String] :region
|
106
106
|
# The AWS region to connect to. The configured `:region` is
|
107
107
|
# used to determine the service `:endpoint`. When not passed,
|
108
|
-
# a default `:region` is
|
108
|
+
# a default `:region` is searched for in the following locations:
|
109
109
|
#
|
110
110
|
# * `Aws.config[:region]`
|
111
111
|
# * `ENV['AWS_REGION']`
|
@@ -161,7 +161,7 @@ module Aws::CostExplorer
|
|
161
161
|
# @option options [String] :endpoint
|
162
162
|
# The client endpoint is normally constructed from the `:region`
|
163
163
|
# option. You should only configure an `:endpoint` when connecting
|
164
|
-
# to test endpoints. This should be
|
164
|
+
# to test endpoints. This should be a valid HTTP(S) URI.
|
165
165
|
#
|
166
166
|
# @option options [Integer] :endpoint_cache_max_entries (1000)
|
167
167
|
# Used for the maximum size limit of the LRU cache storing endpoints data
|
@@ -176,7 +176,7 @@ module Aws::CostExplorer
|
|
176
176
|
# requests fetching endpoints information. Defaults to 60 sec.
|
177
177
|
#
|
178
178
|
# @option options [Boolean] :endpoint_discovery (false)
|
179
|
-
# When set to `true`, endpoint discovery will be enabled for operations when available.
|
179
|
+
# When set to `true`, endpoint discovery will be enabled for operations when available.
|
180
180
|
#
|
181
181
|
# @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
|
182
182
|
# The log formatter.
|
@@ -279,8 +279,7 @@ module Aws::CostExplorer
|
|
279
279
|
#
|
280
280
|
# @option options [Integer] :http_read_timeout (60) The default
|
281
281
|
# number of seconds to wait for response data. This value can
|
282
|
-
# safely be set
|
283
|
-
# per-request on the session yielded by {#session_for}.
|
282
|
+
# safely be set per-request on the session.
|
284
283
|
#
|
285
284
|
# @option options [Float] :http_idle_timeout (5) The number of
|
286
285
|
# seconds a connection is allowed to sit idle before it is
|
@@ -292,7 +291,7 @@ module Aws::CostExplorer
|
|
292
291
|
# request body. This option has no effect unless the request has
|
293
292
|
# "Expect" header set to "100-continue". Defaults to `nil` which
|
294
293
|
# disables this behaviour. This value can safely be set per
|
295
|
-
# request on the session
|
294
|
+
# request on the session.
|
296
295
|
#
|
297
296
|
# @option options [Boolean] :http_wire_trace (false) When `true`,
|
298
297
|
# HTTP debug output will be sent to the `:logger`.
|
@@ -319,12 +318,6 @@ module Aws::CostExplorer
|
|
319
318
|
|
320
319
|
# @!group API Operations
|
321
320
|
|
322
|
-
# <i> <b>Cost Category is in public beta for AWS Billing and Cost
|
323
|
-
# Management and is subject to change. Your use of Cost Categories is
|
324
|
-
# subject to the Beta Service Participation terms of the <a
|
325
|
-
# href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
|
326
|
-
# (Section 1.10).</b> </i>
|
327
|
-
#
|
328
321
|
# Creates a new Cost Category with the requested name and rules.
|
329
322
|
#
|
330
323
|
# @option params [required, String] :name
|
@@ -334,16 +327,12 @@ module Aws::CostExplorer
|
|
334
327
|
# The rule schema version in this particular Cost Category.
|
335
328
|
#
|
336
329
|
# @option params [required, Array<Types::CostCategoryRule>] :rules
|
337
|
-
#
|
338
|
-
#
|
339
|
-
#
|
330
|
+
# The Cost Category rules used to categorize costs. For more
|
331
|
+
# information, see [CostCategoryRule][1].
|
332
|
+
#
|
340
333
|
#
|
341
|
-
# Root level `OR` is not supported. We recommend you create a separate
|
342
|
-
# rule instead.
|
343
334
|
#
|
344
|
-
#
|
345
|
-
# the line item, then the first rule to match is used to determine that
|
346
|
-
# Cost Category value.
|
335
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategoryRule.html
|
347
336
|
#
|
348
337
|
# @return [Types::CreateCostCategoryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
349
338
|
#
|
@@ -373,12 +362,14 @@ module Aws::CostExplorer
|
|
373
362
|
# # recursive Expression
|
374
363
|
# },
|
375
364
|
# dimensions: {
|
376
|
-
# 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
|
365
|
+
# key: "AZ", # accepts 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
|
377
366
|
# values: ["Value"],
|
367
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
378
368
|
# },
|
379
369
|
# tags: {
|
380
370
|
# key: "TagKey",
|
381
371
|
# values: ["Value"],
|
372
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
382
373
|
# },
|
383
374
|
# cost_categories: {
|
384
375
|
# key: "CostCategoryName",
|
@@ -403,12 +394,6 @@ module Aws::CostExplorer
|
|
403
394
|
req.send_request(options)
|
404
395
|
end
|
405
396
|
|
406
|
-
# <i> <b>Cost Category is in public beta for AWS Billing and Cost
|
407
|
-
# Management and is subject to change. Your use of Cost Categories is
|
408
|
-
# subject to the Beta Service Participation terms of the <a
|
409
|
-
# href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
|
410
|
-
# (Section 1.10).</b> </i>
|
411
|
-
#
|
412
397
|
# Deletes a Cost Category. Expenses from this month going forward will
|
413
398
|
# no longer be categorized with this Cost Category.
|
414
399
|
#
|
@@ -440,12 +425,6 @@ module Aws::CostExplorer
|
|
440
425
|
req.send_request(options)
|
441
426
|
end
|
442
427
|
|
443
|
-
# <i> <b>Cost Category is in public beta for AWS Billing and Cost
|
444
|
-
# Management and is subject to change. Your use of Cost Categories is
|
445
|
-
# subject to the Beta Service Participation terms of the <a
|
446
|
-
# href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
|
447
|
-
# (Section 1.10).</b> </i>
|
448
|
-
#
|
449
428
|
# Returns the name, ARN, rules, definition, and effective dates of a
|
450
429
|
# Cost Category that's defined in the account.
|
451
430
|
#
|
@@ -486,12 +465,16 @@ module Aws::CostExplorer
|
|
486
465
|
# resp.cost_category.rules[0].rule.and #=> Array
|
487
466
|
# resp.cost_category.rules[0].rule.and[0] #=> Types::Expression
|
488
467
|
# resp.cost_category.rules[0].rule.not #=> Types::Expression
|
489
|
-
# 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"
|
468
|
+
# resp.cost_category.rules[0].rule.dimensions.key #=> String, one of "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"
|
490
469
|
# resp.cost_category.rules[0].rule.dimensions.values #=> Array
|
491
470
|
# resp.cost_category.rules[0].rule.dimensions.values[0] #=> String
|
471
|
+
# resp.cost_category.rules[0].rule.dimensions.match_options #=> Array
|
472
|
+
# resp.cost_category.rules[0].rule.dimensions.match_options[0] #=> String, one of "EQUALS", "STARTS_WITH", "ENDS_WITH", "CONTAINS", "CASE_SENSITIVE", "CASE_INSENSITIVE"
|
492
473
|
# resp.cost_category.rules[0].rule.tags.key #=> String
|
493
474
|
# resp.cost_category.rules[0].rule.tags.values #=> Array
|
494
475
|
# resp.cost_category.rules[0].rule.tags.values[0] #=> String
|
476
|
+
# resp.cost_category.rules[0].rule.tags.match_options #=> Array
|
477
|
+
# resp.cost_category.rules[0].rule.tags.match_options[0] #=> String, one of "EQUALS", "STARTS_WITH", "ENDS_WITH", "CONTAINS", "CASE_SENSITIVE", "CASE_INSENSITIVE"
|
495
478
|
# resp.cost_category.rules[0].rule.cost_categories.key #=> String
|
496
479
|
# resp.cost_category.rules[0].rule.cost_categories.values #=> Array
|
497
480
|
# resp.cost_category.rules[0].rule.cost_categories.values[0] #=> String
|
@@ -516,7 +499,7 @@ module Aws::CostExplorer
|
|
516
499
|
#
|
517
500
|
#
|
518
501
|
#
|
519
|
-
# [1]:
|
502
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetDimensionValues.html
|
520
503
|
#
|
521
504
|
# @option params [required, Types::DateInterval] :time_period
|
522
505
|
# Sets the start and end dates for retrieving AWS costs. The start date
|
@@ -539,7 +522,7 @@ module Aws::CostExplorer
|
|
539
522
|
#
|
540
523
|
#
|
541
524
|
#
|
542
|
-
# [1]:
|
525
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
|
543
526
|
#
|
544
527
|
# @option params [Array<String>] :metrics
|
545
528
|
# Which metrics are returned in the query. For more information about
|
@@ -564,7 +547,7 @@ module Aws::CostExplorer
|
|
564
547
|
#
|
565
548
|
#
|
566
549
|
#
|
567
|
-
# [1]:
|
550
|
+
# [1]: http://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
|
568
551
|
#
|
569
552
|
# @option params [Array<Types::GroupDefinition>] :group_by
|
570
553
|
# You can group AWS costs using up to two different groups, either
|
@@ -611,12 +594,14 @@ module Aws::CostExplorer
|
|
611
594
|
# # recursive Expression
|
612
595
|
# },
|
613
596
|
# dimensions: {
|
614
|
-
# 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
|
597
|
+
# key: "AZ", # accepts 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
|
615
598
|
# values: ["Value"],
|
599
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
616
600
|
# },
|
617
601
|
# tags: {
|
618
602
|
# key: "TagKey",
|
619
603
|
# values: ["Value"],
|
604
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
620
605
|
# },
|
621
606
|
# cost_categories: {
|
622
607
|
# key: "CostCategoryName",
|
@@ -681,7 +666,7 @@ module Aws::CostExplorer
|
|
681
666
|
#
|
682
667
|
#
|
683
668
|
#
|
684
|
-
# [1]:
|
669
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetDimensionValues.html
|
685
670
|
# [2]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/ce-access.html
|
686
671
|
#
|
687
672
|
# @option params [required, Types::DateInterval] :time_period
|
@@ -710,7 +695,7 @@ module Aws::CostExplorer
|
|
710
695
|
#
|
711
696
|
#
|
712
697
|
#
|
713
|
-
# [1]:
|
698
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
|
714
699
|
#
|
715
700
|
# @option params [Array<String>] :metrics
|
716
701
|
# Which metrics are returned in the query. For more information about
|
@@ -735,7 +720,7 @@ module Aws::CostExplorer
|
|
735
720
|
#
|
736
721
|
#
|
737
722
|
#
|
738
|
-
# [1]:
|
723
|
+
# [1]: http://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
|
739
724
|
#
|
740
725
|
# @option params [Array<Types::GroupDefinition>] :group_by
|
741
726
|
# You can group Amazon Web Services costs using up to two different
|
@@ -775,12 +760,14 @@ module Aws::CostExplorer
|
|
775
760
|
# # recursive Expression
|
776
761
|
# },
|
777
762
|
# dimensions: {
|
778
|
-
# 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
|
763
|
+
# key: "AZ", # accepts 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
|
779
764
|
# values: ["Value"],
|
765
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
780
766
|
# },
|
781
767
|
# tags: {
|
782
768
|
# key: "TagKey",
|
783
769
|
# values: ["Value"],
|
770
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
784
771
|
# },
|
785
772
|
# cost_categories: {
|
786
773
|
# key: "CostCategoryName",
|
@@ -852,7 +839,7 @@ module Aws::CostExplorer
|
|
852
839
|
#
|
853
840
|
#
|
854
841
|
#
|
855
|
-
# [1]:
|
842
|
+
# [1]: http://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
|
856
843
|
#
|
857
844
|
# @option params [required, String] :granularity
|
858
845
|
# How granular you want the forecast to be. You can get 3 months of
|
@@ -902,12 +889,14 @@ module Aws::CostExplorer
|
|
902
889
|
# # recursive Expression
|
903
890
|
# },
|
904
891
|
# dimensions: {
|
905
|
-
# 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
|
892
|
+
# key: "AZ", # accepts 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
|
906
893
|
# values: ["Value"],
|
894
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
907
895
|
# },
|
908
896
|
# tags: {
|
909
897
|
# key: "TagKey",
|
910
898
|
# values: ["Value"],
|
899
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
911
900
|
# },
|
912
901
|
# cost_categories: {
|
913
902
|
# key: "CostCategoryName",
|
@@ -1083,7 +1072,7 @@ module Aws::CostExplorer
|
|
1083
1072
|
# start: "YearMonthDay", # required
|
1084
1073
|
# end: "YearMonthDay", # required
|
1085
1074
|
# },
|
1086
|
-
# dimension: "AZ", # required, 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
|
1075
|
+
# dimension: "AZ", # required, accepts 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
|
1087
1076
|
# context: "COST_AND_USAGE", # accepts COST_AND_USAGE, RESERVATIONS, SAVINGS_PLANS
|
1088
1077
|
# next_page_token: "NextPageToken",
|
1089
1078
|
# })
|
@@ -1111,7 +1100,8 @@ module Aws::CostExplorer
|
|
1111
1100
|
# to see how much of your Amazon Elastic Compute Cloud, Amazon
|
1112
1101
|
# ElastiCache, Amazon Relational Database Service, or Amazon Redshift
|
1113
1102
|
# usage is covered by a reservation. An organization's master account
|
1114
|
-
# can see the coverage of the associated member accounts.
|
1103
|
+
# can see the coverage of the associated member accounts. This supports
|
1104
|
+
# dimensions, Cost Categories, and nested expressions. For any time
|
1115
1105
|
# period, you can filter data about reservation usage by the following
|
1116
1106
|
# dimensions:
|
1117
1107
|
#
|
@@ -1221,9 +1211,11 @@ module Aws::CostExplorer
|
|
1221
1211
|
# If you don't provide a `SERVICE` filter, Cost Explorer defaults to
|
1222
1212
|
# EC2.
|
1223
1213
|
#
|
1214
|
+
# Cost category is also supported.
|
1215
|
+
#
|
1224
1216
|
#
|
1225
1217
|
#
|
1226
|
-
# [1]:
|
1218
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
|
1227
1219
|
#
|
1228
1220
|
# @option params [Array<String>] :metrics
|
1229
1221
|
# The measurement that you want your reservation coverage reported in.
|
@@ -1271,12 +1263,14 @@ module Aws::CostExplorer
|
|
1271
1263
|
# # recursive Expression
|
1272
1264
|
# },
|
1273
1265
|
# dimensions: {
|
1274
|
-
# 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
|
1266
|
+
# key: "AZ", # accepts 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
|
1275
1267
|
# values: ["Value"],
|
1268
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
1276
1269
|
# },
|
1277
1270
|
# tags: {
|
1278
1271
|
# key: "TagKey",
|
1279
1272
|
# values: ["Value"],
|
1273
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
1280
1274
|
# },
|
1281
1275
|
# cost_categories: {
|
1282
1276
|
# key: "CostCategoryName",
|
@@ -1361,12 +1355,11 @@ module Aws::CostExplorer
|
|
1361
1355
|
# The specific service that you want recommendations for.
|
1362
1356
|
#
|
1363
1357
|
# @option params [String] :account_scope
|
1364
|
-
# The account scope that you want recommendations for.
|
1365
|
-
#
|
1366
|
-
#
|
1367
|
-
#
|
1368
|
-
#
|
1369
|
-
# Valid values are `PAYER` and `LINKED`.
|
1358
|
+
# The account scope that you want your recommendations for. Amazon Web
|
1359
|
+
# Services calculates recommendations including the payer account and
|
1360
|
+
# linked accounts if the value is set to `PAYER`. If the value is
|
1361
|
+
# `LINKED`, recommendations are calculated for individual linked
|
1362
|
+
# accounts only.
|
1370
1363
|
#
|
1371
1364
|
# @option params [String] :lookback_period_in_days
|
1372
1365
|
# The number of previous days that you want AWS to consider when it
|
@@ -1549,7 +1542,7 @@ module Aws::CostExplorer
|
|
1549
1542
|
#
|
1550
1543
|
#
|
1551
1544
|
#
|
1552
|
-
# [1]:
|
1545
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
|
1553
1546
|
#
|
1554
1547
|
# @option params [String] :next_page_token
|
1555
1548
|
# The token to retrieve the next set of results. AWS provides the token
|
@@ -1591,12 +1584,14 @@ module Aws::CostExplorer
|
|
1591
1584
|
# # recursive Expression
|
1592
1585
|
# },
|
1593
1586
|
# dimensions: {
|
1594
|
-
# 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
|
1587
|
+
# key: "AZ", # accepts 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
|
1595
1588
|
# values: ["Value"],
|
1589
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
1596
1590
|
# },
|
1597
1591
|
# tags: {
|
1598
1592
|
# key: "TagKey",
|
1599
1593
|
# values: ["Value"],
|
1594
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
1600
1595
|
# },
|
1601
1596
|
# cost_categories: {
|
1602
1597
|
# key: "CostCategoryName",
|
@@ -1727,6 +1722,14 @@ module Aws::CostExplorer
|
|
1727
1722
|
#
|
1728
1723
|
# </note>
|
1729
1724
|
#
|
1725
|
+
# @option params [Types::RightsizingRecommendationConfiguration] :configuration
|
1726
|
+
# Enables you to customize recommendations across two attributes. You
|
1727
|
+
# can choose to view recommendations for instances within the same
|
1728
|
+
# instance families or across different instance families. You can also
|
1729
|
+
# choose to view your estimated savings associated with recommendations
|
1730
|
+
# with consideration of existing Savings Plans or RI benefits, or
|
1731
|
+
# niether.
|
1732
|
+
#
|
1730
1733
|
# @option params [required, String] :service
|
1731
1734
|
# The specific service that you want recommendations for. The only valid
|
1732
1735
|
# value for `GetRightsizingRecommendation` is "`AmazonEC2`".
|
@@ -1745,6 +1748,7 @@ module Aws::CostExplorer
|
|
1745
1748
|
# * {Types::GetRightsizingRecommendationResponse#summary #summary} => Types::RightsizingRecommendationSummary
|
1746
1749
|
# * {Types::GetRightsizingRecommendationResponse#rightsizing_recommendations #rightsizing_recommendations} => Array<Types::RightsizingRecommendation>
|
1747
1750
|
# * {Types::GetRightsizingRecommendationResponse#next_page_token #next_page_token} => String
|
1751
|
+
# * {Types::GetRightsizingRecommendationResponse#configuration #configuration} => Types::RightsizingRecommendationConfiguration
|
1748
1752
|
#
|
1749
1753
|
# @example Request syntax with placeholder values
|
1750
1754
|
#
|
@@ -1764,18 +1768,24 @@ module Aws::CostExplorer
|
|
1764
1768
|
# # recursive Expression
|
1765
1769
|
# },
|
1766
1770
|
# dimensions: {
|
1767
|
-
# 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
|
1771
|
+
# key: "AZ", # accepts 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
|
1768
1772
|
# values: ["Value"],
|
1773
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
1769
1774
|
# },
|
1770
1775
|
# tags: {
|
1771
1776
|
# key: "TagKey",
|
1772
1777
|
# values: ["Value"],
|
1778
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
1773
1779
|
# },
|
1774
1780
|
# cost_categories: {
|
1775
1781
|
# key: "CostCategoryName",
|
1776
1782
|
# values: ["Value"],
|
1777
1783
|
# },
|
1778
1784
|
# },
|
1785
|
+
# configuration: {
|
1786
|
+
# recommendation_target: "SAME_INSTANCE_FAMILY", # required, accepts SAME_INSTANCE_FAMILY, CROSS_INSTANCE_FAMILY
|
1787
|
+
# benefits_considered: false, # required
|
1788
|
+
# },
|
1779
1789
|
# service: "GenericString", # required
|
1780
1790
|
# page_size: 1,
|
1781
1791
|
# next_page_token: "NextPageToken",
|
@@ -1797,6 +1807,8 @@ module Aws::CostExplorer
|
|
1797
1807
|
# resp.rightsizing_recommendations[0].current_instance.tags[0].key #=> String
|
1798
1808
|
# resp.rightsizing_recommendations[0].current_instance.tags[0].values #=> Array
|
1799
1809
|
# resp.rightsizing_recommendations[0].current_instance.tags[0].values[0] #=> String
|
1810
|
+
# resp.rightsizing_recommendations[0].current_instance.tags[0].match_options #=> Array
|
1811
|
+
# resp.rightsizing_recommendations[0].current_instance.tags[0].match_options[0] #=> String, one of "EQUALS", "STARTS_WITH", "ENDS_WITH", "CONTAINS", "CASE_SENSITIVE", "CASE_INSENSITIVE"
|
1800
1812
|
# resp.rightsizing_recommendations[0].current_instance.resource_details.ec2_resource_details.hourly_on_demand_rate #=> String
|
1801
1813
|
# resp.rightsizing_recommendations[0].current_instance.resource_details.ec2_resource_details.instance_type #=> String
|
1802
1814
|
# resp.rightsizing_recommendations[0].current_instance.resource_details.ec2_resource_details.platform #=> String
|
@@ -1836,6 +1848,8 @@ module Aws::CostExplorer
|
|
1836
1848
|
# resp.rightsizing_recommendations[0].terminate_recommendation_detail.estimated_monthly_savings #=> String
|
1837
1849
|
# resp.rightsizing_recommendations[0].terminate_recommendation_detail.currency_code #=> String
|
1838
1850
|
# resp.next_page_token #=> String
|
1851
|
+
# resp.configuration.recommendation_target #=> String, one of "SAME_INSTANCE_FAMILY", "CROSS_INSTANCE_FAMILY"
|
1852
|
+
# resp.configuration.benefits_considered #=> Boolean
|
1839
1853
|
#
|
1840
1854
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetRightsizingRecommendation AWS API Documentation
|
1841
1855
|
#
|
@@ -1849,7 +1863,8 @@ module Aws::CostExplorer
|
|
1849
1863
|
# Retrieves the Savings Plans covered for your account. This enables you
|
1850
1864
|
# to see how much of your cost is covered by a Savings Plan. An
|
1851
1865
|
# organization’s master account can see the coverage of the associated
|
1852
|
-
# member accounts.
|
1866
|
+
# member accounts. This supports dimensions, Cost Categories, and nested
|
1867
|
+
# expressions. For any time period, you can filter data for Savings
|
1853
1868
|
# Plans usage with the following dimensions:
|
1854
1869
|
#
|
1855
1870
|
# * `LINKED_ACCOUNT`
|
@@ -1896,9 +1911,11 @@ module Aws::CostExplorer
|
|
1896
1911
|
# other operations, but only `AND` is supported among each dimension. If
|
1897
1912
|
# there are multiple values for a dimension, they are OR'd together.
|
1898
1913
|
#
|
1914
|
+
# Cost category is also supported.
|
1915
|
+
#
|
1899
1916
|
#
|
1900
1917
|
#
|
1901
|
-
# [1]:
|
1918
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
|
1902
1919
|
#
|
1903
1920
|
# @option params [Array<String>] :metrics
|
1904
1921
|
# The measurement that you want your Savings Plans coverage reported in.
|
@@ -1918,6 +1935,8 @@ module Aws::CostExplorer
|
|
1918
1935
|
# * {Types::GetSavingsPlansCoverageResponse#savings_plans_coverages #savings_plans_coverages} => Array<Types::SavingsPlansCoverage>
|
1919
1936
|
# * {Types::GetSavingsPlansCoverageResponse#next_token #next_token} => String
|
1920
1937
|
#
|
1938
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1939
|
+
#
|
1921
1940
|
# @example Request syntax with placeholder values
|
1922
1941
|
#
|
1923
1942
|
# resp = client.get_savings_plans_coverage({
|
@@ -1947,12 +1966,14 @@ module Aws::CostExplorer
|
|
1947
1966
|
# # recursive Expression
|
1948
1967
|
# },
|
1949
1968
|
# dimensions: {
|
1950
|
-
# 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
|
1969
|
+
# key: "AZ", # accepts 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
|
1951
1970
|
# values: ["Value"],
|
1971
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
1952
1972
|
# },
|
1953
1973
|
# tags: {
|
1954
1974
|
# key: "TagKey",
|
1955
1975
|
# values: ["Value"],
|
1976
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
1956
1977
|
# },
|
1957
1978
|
# cost_categories: {
|
1958
1979
|
# key: "CostCategoryName",
|
@@ -1999,6 +2020,13 @@ module Aws::CostExplorer
|
|
1999
2020
|
# @option params [required, String] :payment_option
|
2000
2021
|
# The payment option used to generate these recommendations.
|
2001
2022
|
#
|
2023
|
+
# @option params [String] :account_scope
|
2024
|
+
# The account scope that you want your recommendations for. Amazon Web
|
2025
|
+
# Services calculates recommendations including the payer account and
|
2026
|
+
# linked accounts if the value is set to `PAYER`. If the value is
|
2027
|
+
# `LINKED`, recommendations are calculated for individual linked
|
2028
|
+
# accounts only.
|
2029
|
+
#
|
2002
2030
|
# @option params [String] :next_page_token
|
2003
2031
|
# The token to retrieve the next set of results. Amazon Web Services
|
2004
2032
|
# provides the token when the response from a previous call has more
|
@@ -2011,6 +2039,20 @@ module Aws::CostExplorer
|
|
2011
2039
|
# @option params [required, String] :lookback_period_in_days
|
2012
2040
|
# The lookback period used to generate the recommendation.
|
2013
2041
|
#
|
2042
|
+
# @option params [Types::Expression] :filter
|
2043
|
+
# You can filter your recommendations by Account ID with the
|
2044
|
+
# `LINKED_ACCOUNT` dimension. To filter your recommendations by Account
|
2045
|
+
# ID, specify `Key` as `LINKED_ACCOUNT` and `Value` as the
|
2046
|
+
# comma-separated Acount ID(s) for which you want to see Savings Plans
|
2047
|
+
# purchase recommendations.
|
2048
|
+
#
|
2049
|
+
# For GetSavingsPlansPurchaseRecommendation, the `Filter` does not
|
2050
|
+
# include `CostCategories` or `Tags`. It only includes `Dimensions`.
|
2051
|
+
# With `Dimensions`, `Key` must be `LINKED_ACCOUNT` and `Value` can be a
|
2052
|
+
# single Account ID or multiple comma-separated Account IDs for which
|
2053
|
+
# you want to see Savings Plans Purchase Recommendations. `AND` and `OR`
|
2054
|
+
# operators are not supported.
|
2055
|
+
#
|
2014
2056
|
# @return [Types::GetSavingsPlansPurchaseRecommendationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2015
2057
|
#
|
2016
2058
|
# * {Types::GetSavingsPlansPurchaseRecommendationResponse#metadata #metadata} => Types::SavingsPlansPurchaseRecommendationMetadata
|
@@ -2023,15 +2065,46 @@ module Aws::CostExplorer
|
|
2023
2065
|
# savings_plans_type: "COMPUTE_SP", # required, accepts COMPUTE_SP, EC2_INSTANCE_SP
|
2024
2066
|
# term_in_years: "ONE_YEAR", # required, accepts ONE_YEAR, THREE_YEARS
|
2025
2067
|
# payment_option: "NO_UPFRONT", # required, accepts NO_UPFRONT, PARTIAL_UPFRONT, ALL_UPFRONT, LIGHT_UTILIZATION, MEDIUM_UTILIZATION, HEAVY_UTILIZATION
|
2068
|
+
# account_scope: "PAYER", # accepts PAYER, LINKED
|
2026
2069
|
# next_page_token: "NextPageToken",
|
2027
2070
|
# page_size: 1,
|
2028
2071
|
# lookback_period_in_days: "SEVEN_DAYS", # required, accepts SEVEN_DAYS, THIRTY_DAYS, SIXTY_DAYS
|
2072
|
+
# filter: {
|
2073
|
+
# or: [
|
2074
|
+
# {
|
2075
|
+
# # recursive Expression
|
2076
|
+
# },
|
2077
|
+
# ],
|
2078
|
+
# and: [
|
2079
|
+
# {
|
2080
|
+
# # recursive Expression
|
2081
|
+
# },
|
2082
|
+
# ],
|
2083
|
+
# not: {
|
2084
|
+
# # recursive Expression
|
2085
|
+
# },
|
2086
|
+
# dimensions: {
|
2087
|
+
# key: "AZ", # accepts 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
|
2088
|
+
# values: ["Value"],
|
2089
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
2090
|
+
# },
|
2091
|
+
# tags: {
|
2092
|
+
# key: "TagKey",
|
2093
|
+
# values: ["Value"],
|
2094
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
2095
|
+
# },
|
2096
|
+
# cost_categories: {
|
2097
|
+
# key: "CostCategoryName",
|
2098
|
+
# values: ["Value"],
|
2099
|
+
# },
|
2100
|
+
# },
|
2029
2101
|
# })
|
2030
2102
|
#
|
2031
2103
|
# @example Response structure
|
2032
2104
|
#
|
2033
2105
|
# resp.metadata.recommendation_id #=> String
|
2034
2106
|
# resp.metadata.generation_timestamp #=> String
|
2107
|
+
# resp.savings_plans_purchase_recommendation.account_scope #=> String, one of "PAYER", "LINKED"
|
2035
2108
|
# resp.savings_plans_purchase_recommendation.savings_plans_type #=> String, one of "COMPUTE_SP", "EC2_INSTANCE_SP"
|
2036
2109
|
# resp.savings_plans_purchase_recommendation.term_in_years #=> String, one of "ONE_YEAR", "THREE_YEARS"
|
2037
2110
|
# resp.savings_plans_purchase_recommendation.payment_option #=> String, one of "NO_UPFRONT", "PARTIAL_UPFRONT", "ALL_UPFRONT", "LIGHT_UTILIZATION", "MEDIUM_UTILIZATION", "HEAVY_UTILIZATION"
|
@@ -2123,7 +2196,7 @@ module Aws::CostExplorer
|
|
2123
2196
|
#
|
2124
2197
|
#
|
2125
2198
|
#
|
2126
|
-
# [1]:
|
2199
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
|
2127
2200
|
#
|
2128
2201
|
# @return [Types::GetSavingsPlansUtilizationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2129
2202
|
#
|
@@ -2153,12 +2226,14 @@ module Aws::CostExplorer
|
|
2153
2226
|
# # recursive Expression
|
2154
2227
|
# },
|
2155
2228
|
# dimensions: {
|
2156
|
-
# 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
|
2229
|
+
# key: "AZ", # accepts 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
|
2157
2230
|
# values: ["Value"],
|
2231
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
2158
2232
|
# },
|
2159
2233
|
# tags: {
|
2160
2234
|
# key: "TagKey",
|
2161
2235
|
# values: ["Value"],
|
2236
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
2162
2237
|
# },
|
2163
2238
|
# cost_categories: {
|
2164
2239
|
# key: "CostCategoryName",
|
@@ -2240,7 +2315,7 @@ module Aws::CostExplorer
|
|
2240
2315
|
#
|
2241
2316
|
#
|
2242
2317
|
#
|
2243
|
-
# [1]:
|
2318
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
|
2244
2319
|
#
|
2245
2320
|
# @option params [String] :next_token
|
2246
2321
|
# The token to retrieve the next set of results. Amazon Web Services
|
@@ -2258,6 +2333,8 @@ module Aws::CostExplorer
|
|
2258
2333
|
# * {Types::GetSavingsPlansUtilizationDetailsResponse#time_period #time_period} => Types::DateInterval
|
2259
2334
|
# * {Types::GetSavingsPlansUtilizationDetailsResponse#next_token #next_token} => String
|
2260
2335
|
#
|
2336
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
2337
|
+
#
|
2261
2338
|
# @example Request syntax with placeholder values
|
2262
2339
|
#
|
2263
2340
|
# resp = client.get_savings_plans_utilization_details({
|
@@ -2280,12 +2357,14 @@ module Aws::CostExplorer
|
|
2280
2357
|
# # recursive Expression
|
2281
2358
|
# },
|
2282
2359
|
# dimensions: {
|
2283
|
-
# 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
|
2360
|
+
# key: "AZ", # accepts 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
|
2284
2361
|
# values: ["Value"],
|
2362
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
2285
2363
|
# },
|
2286
2364
|
# tags: {
|
2287
2365
|
# key: "TagKey",
|
2288
2366
|
# values: ["Value"],
|
2367
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
2289
2368
|
# },
|
2290
2369
|
# cost_categories: {
|
2291
2370
|
# key: "CostCategoryName",
|
@@ -2459,12 +2538,14 @@ module Aws::CostExplorer
|
|
2459
2538
|
# # recursive Expression
|
2460
2539
|
# },
|
2461
2540
|
# dimensions: {
|
2462
|
-
# 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
|
2541
|
+
# key: "AZ", # accepts 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
|
2463
2542
|
# values: ["Value"],
|
2543
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
2464
2544
|
# },
|
2465
2545
|
# tags: {
|
2466
2546
|
# key: "TagKey",
|
2467
2547
|
# values: ["Value"],
|
2548
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
2468
2549
|
# },
|
2469
2550
|
# cost_categories: {
|
2470
2551
|
# key: "CostCategoryName",
|
@@ -2494,18 +2575,14 @@ module Aws::CostExplorer
|
|
2494
2575
|
req.send_request(options)
|
2495
2576
|
end
|
2496
2577
|
|
2497
|
-
#
|
2498
|
-
#
|
2499
|
-
#
|
2500
|
-
#
|
2501
|
-
#
|
2502
|
-
#
|
2503
|
-
#
|
2504
|
-
#
|
2505
|
-
# return a list of Cost Categories that were active on a specific date.
|
2506
|
-
# If there is no `EffectiveOn` specified, you’ll see Cost Categories
|
2507
|
-
# that are effective on the current date. If Cost Category is still
|
2508
|
-
# effective, `EffectiveEnd` is omitted in the response.
|
2578
|
+
# Returns the name, ARN, `NumberOfRules` and effective dates of all Cost
|
2579
|
+
# Categories defined in the account. You have the option to use
|
2580
|
+
# `EffectiveOn` to return a list of Cost Categories that were active on
|
2581
|
+
# a specific date. If there is no `EffectiveOn` specified, you’ll see
|
2582
|
+
# Cost Categories that are effective on the current date. If Cost
|
2583
|
+
# Category is still effective, `EffectiveEnd` is omitted in the
|
2584
|
+
# response. `ListCostCategoryDefinitions` supports pagination. The
|
2585
|
+
# request can have a `MaxResults` range up to 100.
|
2509
2586
|
#
|
2510
2587
|
# @option params [String] :effective_on
|
2511
2588
|
# The date when the Cost Category was effective.
|
@@ -2515,19 +2592,22 @@ module Aws::CostExplorer
|
|
2515
2592
|
# provides the token when the response from a previous call has more
|
2516
2593
|
# results than the maximum page size.
|
2517
2594
|
#
|
2518
|
-
#
|
2519
|
-
#
|
2595
|
+
# @option params [Integer] :max_results
|
2596
|
+
# The number of entries a paginated response contains.
|
2520
2597
|
#
|
2521
2598
|
# @return [Types::ListCostCategoryDefinitionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2522
2599
|
#
|
2523
2600
|
# * {Types::ListCostCategoryDefinitionsResponse#cost_category_references #cost_category_references} => Array<Types::CostCategoryReference>
|
2524
2601
|
# * {Types::ListCostCategoryDefinitionsResponse#next_token #next_token} => String
|
2525
2602
|
#
|
2603
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
2604
|
+
#
|
2526
2605
|
# @example Request syntax with placeholder values
|
2527
2606
|
#
|
2528
2607
|
# resp = client.list_cost_category_definitions({
|
2529
2608
|
# effective_on: "ZonedDateTime",
|
2530
2609
|
# next_token: "NextPageToken",
|
2610
|
+
# max_results: 1,
|
2531
2611
|
# })
|
2532
2612
|
#
|
2533
2613
|
# @example Response structure
|
@@ -2537,6 +2617,7 @@ module Aws::CostExplorer
|
|
2537
2617
|
# resp.cost_category_references[0].name #=> String
|
2538
2618
|
# resp.cost_category_references[0].effective_start #=> String
|
2539
2619
|
# resp.cost_category_references[0].effective_end #=> String
|
2620
|
+
# resp.cost_category_references[0].number_of_rules #=> Integer
|
2540
2621
|
# resp.next_token #=> String
|
2541
2622
|
#
|
2542
2623
|
# @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/ListCostCategoryDefinitions AWS API Documentation
|
@@ -2548,12 +2629,6 @@ module Aws::CostExplorer
|
|
2548
2629
|
req.send_request(options)
|
2549
2630
|
end
|
2550
2631
|
|
2551
|
-
# <i> <b>Cost Category is in public beta for AWS Billing and Cost
|
2552
|
-
# Management and is subject to change. Your use of Cost Categories is
|
2553
|
-
# subject to the Beta Service Participation terms of the <a
|
2554
|
-
# href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
|
2555
|
-
# (Section 1.10).</b> </i>
|
2556
|
-
#
|
2557
2632
|
# Updates an existing Cost Category. Changes made to the Cost Category
|
2558
2633
|
# rules will be used to categorize the current month’s expenses and
|
2559
2634
|
# future expenses. This won’t change categorization for the previous
|
@@ -2566,16 +2641,12 @@ module Aws::CostExplorer
|
|
2566
2641
|
# The rule schema version in this particular Cost Category.
|
2567
2642
|
#
|
2568
2643
|
# @option params [required, Array<Types::CostCategoryRule>] :rules
|
2569
|
-
# `
|
2570
|
-
#
|
2571
|
-
#
|
2644
|
+
# The `Expression` object used to categorize costs. For more
|
2645
|
+
# information, see [CostCategoryRule ][1].
|
2646
|
+
#
|
2572
2647
|
#
|
2573
|
-
# Root level `OR` is not supported. We recommend you create a separate
|
2574
|
-
# rule instead.
|
2575
2648
|
#
|
2576
|
-
#
|
2577
|
-
# the line item, then the first rule to match is used to determine that
|
2578
|
-
# Cost Category value.
|
2649
|
+
# [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_CostCategoryRule.html
|
2579
2650
|
#
|
2580
2651
|
# @return [Types::UpdateCostCategoryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2581
2652
|
#
|
@@ -2605,12 +2676,14 @@ module Aws::CostExplorer
|
|
2605
2676
|
# # recursive Expression
|
2606
2677
|
# },
|
2607
2678
|
# dimensions: {
|
2608
|
-
# 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
|
2679
|
+
# key: "AZ", # accepts 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
|
2609
2680
|
# values: ["Value"],
|
2681
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
2610
2682
|
# },
|
2611
2683
|
# tags: {
|
2612
2684
|
# key: "TagKey",
|
2613
2685
|
# values: ["Value"],
|
2686
|
+
# match_options: ["EQUALS"], # accepts EQUALS, STARTS_WITH, ENDS_WITH, CONTAINS, CASE_SENSITIVE, CASE_INSENSITIVE
|
2614
2687
|
# },
|
2615
2688
|
# cost_categories: {
|
2616
2689
|
# key: "CostCategoryName",
|
@@ -2648,7 +2721,7 @@ module Aws::CostExplorer
|
|
2648
2721
|
params: params,
|
2649
2722
|
config: config)
|
2650
2723
|
context[:gem_name] = 'aws-sdk-costexplorer'
|
2651
|
-
context[:gem_version] = '1.
|
2724
|
+
context[:gem_version] = '1.42.0'
|
2652
2725
|
Seahorse::Client::Request.new(handlers, context)
|
2653
2726
|
end
|
2654
2727
|
|