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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 2b9ed73e6465e9953bf49ffe783c4484fb64e3e389e614c41b54fe5c5a89a998
4
- data.tar.gz: f4202e1392fb96a8c03d04e1b698214cb5a77d4502f0491b9ea6feefd0e6ad3d
3
+ metadata.gz: 49897667ca86fa355c32fd2e31e574def48689717a011dbe92e9b77130d4299e
4
+ data.tar.gz: ebe36f0f6680f0215c669cac80da6fc4a9612c979619721814265f22c629cd6c
5
5
  SHA512:
6
- metadata.gz: e31c7be554203a1301c1720561d565a0ed6f7bc3a53a5c2ece0780c010f06e496874abc77d396d90b7b0051cdbcffd9e17a47f7af60c932a08e2b975aee70cbc
7
- data.tar.gz: 22ff2c7c127340494655500e360f37d7fc13adbb4a25e545cbe95464efe60563f8312effc4c3d20bf269ae0f40e0098d6e5b8ffedec5715139c85dff8e52a7c7
6
+ metadata.gz: 3529c9cb7f249daf2bd76991a66b553eb261afc451f102ac813029c362c7453a7e84ce8b2f8f459b41cfc5a479b0cfe6c131cdd73e2af33beb767b436b09adcd
7
+ data.tar.gz: 95a0e118299cdf27c4dcb9a8a285f9a313516f0a9ec0f07d01e66b8df0662d4138c5fbcd9100afdba43ab1e87c63cbf9653984e934cd3e651c8f54b94eeb325a
@@ -45,6 +45,6 @@ require_relative 'aws-sdk-costexplorer/customizations'
45
45
  # @service
46
46
  module Aws::CostExplorer
47
47
 
48
- GEM_VERSION = '1.37.0'
48
+ GEM_VERSION = '1.42.0'
49
49
 
50
50
  end
@@ -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 search for in the following locations:
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 avalid HTTP(S) URI.
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. Defaults to `false`.
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 yielded by {#session_for}.
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
- # `CreateCostCategoryDefinition` supports dimensions, Tags, and nested
338
- # expressions. Currently the only dimensions supported is
339
- # `LINKED_ACCOUNT`.
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
- # Rules are processed in order. If there are multiple rules that match
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]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetDimensionValues.html
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]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
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]: https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
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]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetDimensionValues.html
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]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
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]: https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
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]: https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
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. For any time
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]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
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. `PAYER` means
1365
- # that AWS includes the master account and any member accounts when it
1366
- # calculates its recommendations. `LINKED` means that AWS includes only
1367
- # member accounts when it calculates its recommendations.
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]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
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&lt;Types::RightsizingRecommendation&gt;
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. For any time period, you can filter data for Savings
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]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
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&lt;Types::SavingsPlansCoverage&gt;
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]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
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]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
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
- # <i> <b>Cost Category is in public beta for AWS Billing and Cost
2498
- # Management and is subject to change. Your use of Cost Categories is
2499
- # subject to the Beta Service Participation terms of the <a
2500
- # href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
2501
- # (Section 1.10).</b> </i>
2502
- #
2503
- # Returns the name, ARN and effective dates of all Cost Categories
2504
- # defined in the account. You have the option to use `EffectiveOn` to
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
- # You can use this information to retrieve the full Cost Category
2519
- # information using `DescribeCostCategory`.
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&lt;Types::CostCategoryReference&gt;
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
- # `UpdateCostCategoryDefinition` supports dimensions, Tags, and nested
2570
- # expressions. Currently the only dimensions supported is
2571
- # `LINKED_ACCOUNT`.
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
- # Rules are processed in order. If there are multiple rules that match
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.37.0'
2724
+ context[:gem_version] = '1.42.0'
2652
2725
  Seahorse::Client::Request.new(handlers, context)
2653
2726
  end
2654
2727