aws-sdk-costexplorer 1.37.0 → 1.38.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
- SHA256:
3
- metadata.gz: 2b9ed73e6465e9953bf49ffe783c4484fb64e3e389e614c41b54fe5c5a89a998
4
- data.tar.gz: f4202e1392fb96a8c03d04e1b698214cb5a77d4502f0491b9ea6feefd0e6ad3d
2
+ SHA1:
3
+ metadata.gz: 75c6cdf232d9461b1b2e82c9751a5c69954ffecd
4
+ data.tar.gz: 34723a0b8191ef14a91e95c3311307376da2ca54
5
5
  SHA512:
6
- metadata.gz: e31c7be554203a1301c1720561d565a0ed6f7bc3a53a5c2ece0780c010f06e496874abc77d396d90b7b0051cdbcffd9e17a47f7af60c932a08e2b975aee70cbc
7
- data.tar.gz: 22ff2c7c127340494655500e360f37d7fc13adbb4a25e545cbe95464efe60563f8312effc4c3d20bf269ae0f40e0098d6e5b8ffedec5715139c85dff8e52a7c7
6
+ metadata.gz: 56572f2e23b82d87c5d61a66f3e025dbb0774d5f90d47024c5c644aa4f0207e4314269f812aee32cf66a44c3d6b0c9dd6054fe6be01b401bdbb37394ce1bac8d
7
+ data.tar.gz: ff6e2afe928caf74761ebd5caf2c63d75df12db94b4448ffb86ad8d647f5369f06e57a8b163a8b3e63a75ff1f187f9846c67f6694cdc6bca557e768fbb06d4a4
@@ -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.38.0'
49
49
 
50
50
  end
@@ -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`.
@@ -322,7 +321,7 @@ module Aws::CostExplorer
322
321
  # <i> <b>Cost Category is in public beta for AWS Billing and Cost
323
322
  # Management and is subject to change. Your use of Cost Categories is
324
323
  # subject to the Beta Service Participation terms of the <a
325
- # href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
324
+ # href="http://aws.amazon.com/service-terms/">AWS Service Terms</a>
326
325
  # (Section 1.10).</b> </i>
327
326
  #
328
327
  # Creates a new Cost Category with the requested name and rules.
@@ -406,7 +405,7 @@ module Aws::CostExplorer
406
405
  # <i> <b>Cost Category is in public beta for AWS Billing and Cost
407
406
  # Management and is subject to change. Your use of Cost Categories is
408
407
  # subject to the Beta Service Participation terms of the <a
409
- # href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
408
+ # href="http://aws.amazon.com/service-terms/">AWS Service Terms</a>
410
409
  # (Section 1.10).</b> </i>
411
410
  #
412
411
  # Deletes a Cost Category. Expenses from this month going forward will
@@ -443,7 +442,7 @@ module Aws::CostExplorer
443
442
  # <i> <b>Cost Category is in public beta for AWS Billing and Cost
444
443
  # Management and is subject to change. Your use of Cost Categories is
445
444
  # subject to the Beta Service Participation terms of the <a
446
- # href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
445
+ # href="http://aws.amazon.com/service-terms/">AWS Service Terms</a>
447
446
  # (Section 1.10).</b> </i>
448
447
  #
449
448
  # Returns the name, ARN, rules, definition, and effective dates of a
@@ -516,7 +515,7 @@ module Aws::CostExplorer
516
515
  #
517
516
  #
518
517
  #
519
- # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetDimensionValues.html
518
+ # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_GetDimensionValues.html
520
519
  #
521
520
  # @option params [required, Types::DateInterval] :time_period
522
521
  # Sets the start and end dates for retrieving AWS costs. The start date
@@ -539,7 +538,7 @@ module Aws::CostExplorer
539
538
  #
540
539
  #
541
540
  #
542
- # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
541
+ # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
543
542
  #
544
543
  # @option params [Array<String>] :metrics
545
544
  # Which metrics are returned in the query. For more information about
@@ -564,7 +563,7 @@ module Aws::CostExplorer
564
563
  #
565
564
  #
566
565
  #
567
- # [1]: https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
566
+ # [1]: http://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
568
567
  #
569
568
  # @option params [Array<Types::GroupDefinition>] :group_by
570
569
  # You can group AWS costs using up to two different groups, either
@@ -852,7 +851,7 @@ module Aws::CostExplorer
852
851
  #
853
852
  #
854
853
  #
855
- # [1]: https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
854
+ # [1]: http://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
856
855
  #
857
856
  # @option params [required, String] :granularity
858
857
  # How granular you want the forecast to be. You can get 3 months of
@@ -1223,7 +1222,7 @@ module Aws::CostExplorer
1223
1222
  #
1224
1223
  #
1225
1224
  #
1226
- # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
1225
+ # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
1227
1226
  #
1228
1227
  # @option params [Array<String>] :metrics
1229
1228
  # The measurement that you want your reservation coverage reported in.
@@ -1361,12 +1360,11 @@ module Aws::CostExplorer
1361
1360
  # The specific service that you want recommendations for.
1362
1361
  #
1363
1362
  # @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`.
1363
+ # The account scope that you want your recommendations for. Amazon Web
1364
+ # Services calculates recommendations including the payer account and
1365
+ # linked accounts if the value is set to `PAYER`. If the value is
1366
+ # `LINKED`, recommendations are calculated for individual linked
1367
+ # accounts only.
1370
1368
  #
1371
1369
  # @option params [String] :lookback_period_in_days
1372
1370
  # The number of previous days that you want AWS to consider when it
@@ -1549,7 +1547,7 @@ module Aws::CostExplorer
1549
1547
  #
1550
1548
  #
1551
1549
  #
1552
- # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
1550
+ # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
1553
1551
  #
1554
1552
  # @option params [String] :next_page_token
1555
1553
  # The token to retrieve the next set of results. AWS provides the token
@@ -1898,7 +1896,7 @@ module Aws::CostExplorer
1898
1896
  #
1899
1897
  #
1900
1898
  #
1901
- # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
1899
+ # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
1902
1900
  #
1903
1901
  # @option params [Array<String>] :metrics
1904
1902
  # The measurement that you want your Savings Plans coverage reported in.
@@ -1918,6 +1916,8 @@ module Aws::CostExplorer
1918
1916
  # * {Types::GetSavingsPlansCoverageResponse#savings_plans_coverages #savings_plans_coverages} => Array&lt;Types::SavingsPlansCoverage&gt;
1919
1917
  # * {Types::GetSavingsPlansCoverageResponse#next_token #next_token} => String
1920
1918
  #
1919
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1920
+ #
1921
1921
  # @example Request syntax with placeholder values
1922
1922
  #
1923
1923
  # resp = client.get_savings_plans_coverage({
@@ -1999,6 +1999,13 @@ module Aws::CostExplorer
1999
1999
  # @option params [required, String] :payment_option
2000
2000
  # The payment option used to generate these recommendations.
2001
2001
  #
2002
+ # @option params [String] :account_scope
2003
+ # The account scope that you want your recommendations for. Amazon Web
2004
+ # Services calculates recommendations including the payer account and
2005
+ # linked accounts if the value is set to `PAYER`. If the value is
2006
+ # `LINKED`, recommendations are calculated for individual linked
2007
+ # accounts only.
2008
+ #
2002
2009
  # @option params [String] :next_page_token
2003
2010
  # The token to retrieve the next set of results. Amazon Web Services
2004
2011
  # provides the token when the response from a previous call has more
@@ -2011,6 +2018,20 @@ module Aws::CostExplorer
2011
2018
  # @option params [required, String] :lookback_period_in_days
2012
2019
  # The lookback period used to generate the recommendation.
2013
2020
  #
2021
+ # @option params [Types::Expression] :filter
2022
+ # You can filter your recommendations by Account ID with the
2023
+ # `LINKED_ACCOUNT` dimension. To filter your recommendations by Account
2024
+ # ID, specify `Key` as `LINKED_ACCOUNT` and `Value` as the
2025
+ # comma-separated Acount ID(s) for which you want to see Savings Plans
2026
+ # purchase recommendations.
2027
+ #
2028
+ # For GetSavingsPlansPurchaseRecommendation, the `Filter` does not
2029
+ # include `CostCategories` or `Tags`. It only includes `Dimensions`.
2030
+ # With `Dimensions`, `Key` must be `LINKED_ACCOUNT` and `Value` can be a
2031
+ # single Account ID or multiple comma-separated Account IDs for which
2032
+ # you want to see Savings Plans Purchase Recommendations. `AND` and `OR`
2033
+ # operators are not supported.
2034
+ #
2014
2035
  # @return [Types::GetSavingsPlansPurchaseRecommendationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2015
2036
  #
2016
2037
  # * {Types::GetSavingsPlansPurchaseRecommendationResponse#metadata #metadata} => Types::SavingsPlansPurchaseRecommendationMetadata
@@ -2023,15 +2044,44 @@ module Aws::CostExplorer
2023
2044
  # savings_plans_type: "COMPUTE_SP", # required, accepts COMPUTE_SP, EC2_INSTANCE_SP
2024
2045
  # term_in_years: "ONE_YEAR", # required, accepts ONE_YEAR, THREE_YEARS
2025
2046
  # payment_option: "NO_UPFRONT", # required, accepts NO_UPFRONT, PARTIAL_UPFRONT, ALL_UPFRONT, LIGHT_UTILIZATION, MEDIUM_UTILIZATION, HEAVY_UTILIZATION
2047
+ # account_scope: "PAYER", # accepts PAYER, LINKED
2026
2048
  # next_page_token: "NextPageToken",
2027
2049
  # page_size: 1,
2028
2050
  # lookback_period_in_days: "SEVEN_DAYS", # required, accepts SEVEN_DAYS, THIRTY_DAYS, SIXTY_DAYS
2051
+ # filter: {
2052
+ # or: [
2053
+ # {
2054
+ # # recursive Expression
2055
+ # },
2056
+ # ],
2057
+ # and: [
2058
+ # {
2059
+ # # recursive Expression
2060
+ # },
2061
+ # ],
2062
+ # not: {
2063
+ # # recursive Expression
2064
+ # },
2065
+ # dimensions: {
2066
+ # 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
2067
+ # values: ["Value"],
2068
+ # },
2069
+ # tags: {
2070
+ # key: "TagKey",
2071
+ # values: ["Value"],
2072
+ # },
2073
+ # cost_categories: {
2074
+ # key: "CostCategoryName",
2075
+ # values: ["Value"],
2076
+ # },
2077
+ # },
2029
2078
  # })
2030
2079
  #
2031
2080
  # @example Response structure
2032
2081
  #
2033
2082
  # resp.metadata.recommendation_id #=> String
2034
2083
  # resp.metadata.generation_timestamp #=> String
2084
+ # resp.savings_plans_purchase_recommendation.account_scope #=> String, one of "PAYER", "LINKED"
2035
2085
  # resp.savings_plans_purchase_recommendation.savings_plans_type #=> String, one of "COMPUTE_SP", "EC2_INSTANCE_SP"
2036
2086
  # resp.savings_plans_purchase_recommendation.term_in_years #=> String, one of "ONE_YEAR", "THREE_YEARS"
2037
2087
  # resp.savings_plans_purchase_recommendation.payment_option #=> String, one of "NO_UPFRONT", "PARTIAL_UPFRONT", "ALL_UPFRONT", "LIGHT_UTILIZATION", "MEDIUM_UTILIZATION", "HEAVY_UTILIZATION"
@@ -2123,7 +2173,7 @@ module Aws::CostExplorer
2123
2173
  #
2124
2174
  #
2125
2175
  #
2126
- # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
2176
+ # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
2127
2177
  #
2128
2178
  # @return [Types::GetSavingsPlansUtilizationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2129
2179
  #
@@ -2240,7 +2290,7 @@ module Aws::CostExplorer
2240
2290
  #
2241
2291
  #
2242
2292
  #
2243
- # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
2293
+ # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
2244
2294
  #
2245
2295
  # @option params [String] :next_token
2246
2296
  # The token to retrieve the next set of results. Amazon Web Services
@@ -2258,6 +2308,8 @@ module Aws::CostExplorer
2258
2308
  # * {Types::GetSavingsPlansUtilizationDetailsResponse#time_period #time_period} => Types::DateInterval
2259
2309
  # * {Types::GetSavingsPlansUtilizationDetailsResponse#next_token #next_token} => String
2260
2310
  #
2311
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2312
+ #
2261
2313
  # @example Request syntax with placeholder values
2262
2314
  #
2263
2315
  # resp = client.get_savings_plans_utilization_details({
@@ -2497,7 +2549,7 @@ module Aws::CostExplorer
2497
2549
  # <i> <b>Cost Category is in public beta for AWS Billing and Cost
2498
2550
  # Management and is subject to change. Your use of Cost Categories is
2499
2551
  # subject to the Beta Service Participation terms of the <a
2500
- # href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
2552
+ # href="http://aws.amazon.com/service-terms/">AWS Service Terms</a>
2501
2553
  # (Section 1.10).</b> </i>
2502
2554
  #
2503
2555
  # Returns the name, ARN and effective dates of all Cost Categories
@@ -2551,7 +2603,7 @@ module Aws::CostExplorer
2551
2603
  # <i> <b>Cost Category is in public beta for AWS Billing and Cost
2552
2604
  # Management and is subject to change. Your use of Cost Categories is
2553
2605
  # subject to the Beta Service Participation terms of the <a
2554
- # href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
2606
+ # href="http://aws.amazon.com/service-terms/">AWS Service Terms</a>
2555
2607
  # (Section 1.10).</b> </i>
2556
2608
  #
2557
2609
  # Updates an existing Cost Category. Changes made to the Cost Category
@@ -2648,7 +2700,7 @@ module Aws::CostExplorer
2648
2700
  params: params,
2649
2701
  config: config)
2650
2702
  context[:gem_name] = 'aws-sdk-costexplorer'
2651
- context[:gem_version] = '1.37.0'
2703
+ context[:gem_version] = '1.38.0'
2652
2704
  Seahorse::Client::Request.new(handlers, context)
2653
2705
  end
2654
2706
 
@@ -500,9 +500,11 @@ module Aws::CostExplorer
500
500
  GetSavingsPlansPurchaseRecommendationRequest.add_member(:savings_plans_type, Shapes::ShapeRef.new(shape: SupportedSavingsPlansType, required: true, location_name: "SavingsPlansType"))
501
501
  GetSavingsPlansPurchaseRecommendationRequest.add_member(:term_in_years, Shapes::ShapeRef.new(shape: TermInYears, required: true, location_name: "TermInYears"))
502
502
  GetSavingsPlansPurchaseRecommendationRequest.add_member(:payment_option, Shapes::ShapeRef.new(shape: PaymentOption, required: true, location_name: "PaymentOption"))
503
+ GetSavingsPlansPurchaseRecommendationRequest.add_member(:account_scope, Shapes::ShapeRef.new(shape: AccountScope, location_name: "AccountScope"))
503
504
  GetSavingsPlansPurchaseRecommendationRequest.add_member(:next_page_token, Shapes::ShapeRef.new(shape: NextPageToken, location_name: "NextPageToken"))
504
505
  GetSavingsPlansPurchaseRecommendationRequest.add_member(:page_size, Shapes::ShapeRef.new(shape: NonNegativeInteger, location_name: "PageSize"))
505
506
  GetSavingsPlansPurchaseRecommendationRequest.add_member(:lookback_period_in_days, Shapes::ShapeRef.new(shape: LookbackPeriodInDays, required: true, location_name: "LookbackPeriodInDays"))
507
+ GetSavingsPlansPurchaseRecommendationRequest.add_member(:filter, Shapes::ShapeRef.new(shape: Expression, location_name: "Filter"))
506
508
  GetSavingsPlansPurchaseRecommendationRequest.struct_class = Types::GetSavingsPlansPurchaseRecommendationRequest
507
509
 
508
510
  GetSavingsPlansPurchaseRecommendationResponse.add_member(:metadata, Shapes::ShapeRef.new(shape: SavingsPlansPurchaseRecommendationMetadata, location_name: "Metadata"))
@@ -755,6 +757,7 @@ module Aws::CostExplorer
755
757
  SavingsPlansDetails.add_member(:offering_id, Shapes::ShapeRef.new(shape: GenericString, location_name: "OfferingId"))
756
758
  SavingsPlansDetails.struct_class = Types::SavingsPlansDetails
757
759
 
760
+ SavingsPlansPurchaseRecommendation.add_member(:account_scope, Shapes::ShapeRef.new(shape: AccountScope, location_name: "AccountScope"))
758
761
  SavingsPlansPurchaseRecommendation.add_member(:savings_plans_type, Shapes::ShapeRef.new(shape: SupportedSavingsPlansType, location_name: "SavingsPlansType"))
759
762
  SavingsPlansPurchaseRecommendation.add_member(:term_in_years, Shapes::ShapeRef.new(shape: TermInYears, location_name: "TermInYears"))
760
763
  SavingsPlansPurchaseRecommendation.add_member(:payment_option, Shapes::ShapeRef.new(shape: PaymentOption, location_name: "PaymentOption"))
@@ -6,13 +6,7 @@
6
6
  # WARNING ABOUT GENERATED CODE
7
7
 
8
8
  module Aws::CostExplorer
9
- # This class provides a resource oriented interface for CostExplorer.
10
- # To create a resource object:
11
- # resource = Aws::CostExplorer::Resource.new(region: 'us-west-2')
12
- # You can supply a client object with custom configuration that will be used for all resource operations.
13
- # If you do not pass +:client+, a default client will be constructed.
14
- # client = Aws::CostExplorer::Client.new(region: 'us-west-2')
15
- # resource = Aws::CostExplorer::Resource.new(client: client)
9
+
16
10
  class Resource
17
11
 
18
12
  # @param options ({})
@@ -23,7 +23,7 @@ module Aws::CostExplorer
23
23
  # <i> <b>Cost Category is in public beta for AWS Billing and Cost
24
24
  # Management and is subject to change. Your use of Cost Categories is
25
25
  # subject to the Beta Service Participation terms of the <a
26
- # href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
26
+ # href="http://aws.amazon.com/service-terms/">AWS Service Terms</a>
27
27
  # (Section 1.10).</b> </i>
28
28
  #
29
29
  # The structure of Cost Categories. This includes detailed metadata and
@@ -70,7 +70,7 @@ module Aws::CostExplorer
70
70
  # <i> <b>Cost Category is in public beta for AWS Billing and Cost
71
71
  # Management and is subject to change. Your use of Cost Categories is
72
72
  # subject to the Beta Service Participation terms of the <a
73
- # href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
73
+ # href="http://aws.amazon.com/service-terms/">AWS Service Terms</a>
74
74
  # (Section 1.10).</b> </i>
75
75
  #
76
76
  # A reference to a Cost Category containing only enough information to
@@ -108,7 +108,7 @@ module Aws::CostExplorer
108
108
  # <i> <b>Cost Category is in public beta for AWS Billing and Cost
109
109
  # Management and is subject to change. Your use of Cost Categories is
110
110
  # subject to the Beta Service Participation terms of the <a
111
- # href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
111
+ # href="http://aws.amazon.com/service-terms/">AWS Service Terms</a>
112
112
  # (Section 1.10).</b> </i>
113
113
  #
114
114
  # Rules are processed in order. If there are multiple rules that match
@@ -164,7 +164,7 @@ module Aws::CostExplorer
164
164
  #
165
165
  #
166
166
  #
167
- # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
167
+ # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
168
168
  # @return [Types::Expression]
169
169
  #
170
170
  # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/CostCategoryRule AWS API Documentation
@@ -178,7 +178,7 @@ module Aws::CostExplorer
178
178
  # <i> <b>Cost Category is in public beta for AWS Billing and Cost
179
179
  # Management and is subject to change. Your use of Cost Categories is
180
180
  # subject to the Beta Service Participation terms of the <a
181
- # href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
181
+ # href="http://aws.amazon.com/service-terms/">AWS Service Terms</a>
182
182
  # (Section 1.10).</b> </i>
183
183
  #
184
184
  # The values that are available for Cost Categories.
@@ -599,7 +599,7 @@ module Aws::CostExplorer
599
599
  # <i> <b>Cost Category is in public beta for AWS Billing and Cost
600
600
  # Management and is subject to change. Your use of Cost Categories is
601
601
  # subject to the Beta Service Participation terms of the <a
602
- # href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
602
+ # href="http://aws.amazon.com/service-terms/">AWS Service Terms</a>
603
603
  # (Section 1.10).</b> </i>
604
604
  #
605
605
  # The structure of Cost Categories. This includes detailed metadata
@@ -1058,7 +1058,7 @@ module Aws::CostExplorer
1058
1058
  # <i> <b>Cost Category is in public beta for AWS Billing and Cost
1059
1059
  # Management and is subject to change. Your use of Cost Categories is
1060
1060
  # subject to the Beta Service Participation terms of the <a
1061
- # href="https://aws.amazon.com/service-terms/">AWS Service Terms</a>
1061
+ # href="http://aws.amazon.com/service-terms/">AWS Service Terms</a>
1062
1062
  # (Section 1.10).</b> </i>
1063
1063
  #
1064
1064
  # The specific `CostCategory` used for `Expression`.
@@ -1173,7 +1173,7 @@ module Aws::CostExplorer
1173
1173
  #
1174
1174
  #
1175
1175
  #
1176
- # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
1176
+ # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
1177
1177
  # @return [Types::Expression]
1178
1178
  #
1179
1179
  # @!attribute [rw] metrics
@@ -1199,7 +1199,7 @@ module Aws::CostExplorer
1199
1199
  #
1200
1200
  #
1201
1201
  #
1202
- # [1]: https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
1202
+ # [1]: http://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
1203
1203
  # @return [Array<String>]
1204
1204
  #
1205
1205
  # @!attribute [rw] group_by
@@ -1469,7 +1469,7 @@ module Aws::CostExplorer
1469
1469
  #
1470
1470
  #
1471
1471
  #
1472
- # [1]: https://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
1472
+ # [1]: http://aws.amazon.com/premiumsupport/knowledge-center/blended-rates-intro/
1473
1473
  # @return [String]
1474
1474
  #
1475
1475
  # @!attribute [rw] granularity
@@ -1944,7 +1944,7 @@ module Aws::CostExplorer
1944
1944
  #
1945
1945
  #
1946
1946
  #
1947
- # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
1947
+ # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
1948
1948
  # @return [Types::Expression]
1949
1949
  #
1950
1950
  # @!attribute [rw] metrics
@@ -2023,12 +2023,11 @@ module Aws::CostExplorer
2023
2023
  # @return [String]
2024
2024
  #
2025
2025
  # @!attribute [rw] account_scope
2026
- # The account scope that you want recommendations for. `PAYER` means
2027
- # that AWS includes the master account and any member accounts when it
2028
- # calculates its recommendations. `LINKED` means that AWS includes
2029
- # only member accounts when it calculates its recommendations.
2030
- #
2031
- # Valid values are `PAYER` and `LINKED`.
2026
+ # The account scope that you want your recommendations for. Amazon Web
2027
+ # Services calculates recommendations including the payer account and
2028
+ # linked accounts if the value is set to `PAYER`. If the value is
2029
+ # `LINKED`, recommendations are calculated for individual linked
2030
+ # accounts only.
2032
2031
  # @return [String]
2033
2032
  #
2034
2033
  # @!attribute [rw] lookback_period_in_days
@@ -2197,7 +2196,7 @@ module Aws::CostExplorer
2197
2196
  #
2198
2197
  #
2199
2198
  #
2200
- # [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
2201
2200
  # @return [Types::Expression]
2202
2201
  #
2203
2202
  # @!attribute [rw] next_page_token
@@ -2462,7 +2461,7 @@ module Aws::CostExplorer
2462
2461
  #
2463
2462
  #
2464
2463
  #
2465
- # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
2464
+ # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
2466
2465
  # @return [Types::Expression]
2467
2466
  #
2468
2467
  # @!attribute [rw] metrics
@@ -2519,9 +2518,37 @@ module Aws::CostExplorer
2519
2518
  # savings_plans_type: "COMPUTE_SP", # required, accepts COMPUTE_SP, EC2_INSTANCE_SP
2520
2519
  # term_in_years: "ONE_YEAR", # required, accepts ONE_YEAR, THREE_YEARS
2521
2520
  # payment_option: "NO_UPFRONT", # required, accepts NO_UPFRONT, PARTIAL_UPFRONT, ALL_UPFRONT, LIGHT_UTILIZATION, MEDIUM_UTILIZATION, HEAVY_UTILIZATION
2521
+ # account_scope: "PAYER", # accepts PAYER, LINKED
2522
2522
  # next_page_token: "NextPageToken",
2523
2523
  # page_size: 1,
2524
2524
  # lookback_period_in_days: "SEVEN_DAYS", # required, accepts SEVEN_DAYS, THIRTY_DAYS, SIXTY_DAYS
2525
+ # filter: {
2526
+ # or: [
2527
+ # {
2528
+ # # recursive Expression
2529
+ # },
2530
+ # ],
2531
+ # and: [
2532
+ # {
2533
+ # # recursive Expression
2534
+ # },
2535
+ # ],
2536
+ # not: {
2537
+ # # recursive Expression
2538
+ # },
2539
+ # dimensions: {
2540
+ # 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
+ # values: ["Value"],
2542
+ # },
2543
+ # tags: {
2544
+ # key: "TagKey",
2545
+ # values: ["Value"],
2546
+ # },
2547
+ # cost_categories: {
2548
+ # key: "CostCategoryName",
2549
+ # values: ["Value"],
2550
+ # },
2551
+ # },
2525
2552
  # }
2526
2553
  #
2527
2554
  # @!attribute [rw] savings_plans_type
@@ -2537,6 +2564,14 @@ module Aws::CostExplorer
2537
2564
  # The payment option used to generate these recommendations.
2538
2565
  # @return [String]
2539
2566
  #
2567
+ # @!attribute [rw] account_scope
2568
+ # The account scope that you want your recommendations for. Amazon Web
2569
+ # Services calculates recommendations including the payer account and
2570
+ # linked accounts if the value is set to `PAYER`. If the value is
2571
+ # `LINKED`, recommendations are calculated for individual linked
2572
+ # accounts only.
2573
+ # @return [String]
2574
+ #
2540
2575
  # @!attribute [rw] next_page_token
2541
2576
  # The token to retrieve the next set of results. Amazon Web Services
2542
2577
  # provides the token when the response from a previous call has more
@@ -2552,15 +2587,32 @@ module Aws::CostExplorer
2552
2587
  # The lookback period used to generate the recommendation.
2553
2588
  # @return [String]
2554
2589
  #
2590
+ # @!attribute [rw] filter
2591
+ # You can filter your recommendations by Account ID with the
2592
+ # `LINKED_ACCOUNT` dimension. To filter your recommendations by
2593
+ # Account ID, specify `Key` as `LINKED_ACCOUNT` and `Value` as the
2594
+ # comma-separated Acount ID(s) for which you want to see Savings Plans
2595
+ # purchase recommendations.
2596
+ #
2597
+ # For GetSavingsPlansPurchaseRecommendation, the `Filter` does not
2598
+ # include `CostCategories` or `Tags`. It only includes `Dimensions`.
2599
+ # With `Dimensions`, `Key` must be `LINKED_ACCOUNT` and `Value` can be
2600
+ # a single Account ID or multiple comma-separated Account IDs for
2601
+ # which you want to see Savings Plans Purchase Recommendations. `AND`
2602
+ # and `OR` operators are not supported.
2603
+ # @return [Types::Expression]
2604
+ #
2555
2605
  # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlansPurchaseRecommendationRequest AWS API Documentation
2556
2606
  #
2557
2607
  class GetSavingsPlansPurchaseRecommendationRequest < Struct.new(
2558
2608
  :savings_plans_type,
2559
2609
  :term_in_years,
2560
2610
  :payment_option,
2611
+ :account_scope,
2561
2612
  :next_page_token,
2562
2613
  :page_size,
2563
- :lookback_period_in_days)
2614
+ :lookback_period_in_days,
2615
+ :filter)
2564
2616
  include Aws::Structure
2565
2617
  end
2566
2618
 
@@ -2654,7 +2706,7 @@ module Aws::CostExplorer
2654
2706
  #
2655
2707
  #
2656
2708
  #
2657
- # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
2709
+ # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
2658
2710
  # @return [Types::Expression]
2659
2711
  #
2660
2712
  # @!attribute [rw] next_token
@@ -2782,7 +2834,7 @@ module Aws::CostExplorer
2782
2834
  #
2783
2835
  #
2784
2836
  #
2785
- # [1]: http://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
2837
+ # [1]: https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html
2786
2838
  # @return [Types::Expression]
2787
2839
  #
2788
2840
  # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/GetSavingsPlansUtilizationRequest AWS API Documentation
@@ -3904,6 +3956,14 @@ module Aws::CostExplorer
3904
3956
  # Contains your request parameters, Savings Plan Recommendations
3905
3957
  # Summary, and Details.
3906
3958
  #
3959
+ # @!attribute [rw] account_scope
3960
+ # The account scope that you want your recommendations for. Amazon Web
3961
+ # Services calculates recommendations including the payer account and
3962
+ # linked accounts if the value is set to `PAYER`. If the value is
3963
+ # `LINKED`, recommendations are calculated for individual linked
3964
+ # accounts only.
3965
+ # @return [String]
3966
+ #
3907
3967
  # @!attribute [rw] savings_plans_type
3908
3968
  # The requested Savings Plans recommendation type.
3909
3969
  # @return [String]
@@ -3933,6 +3993,7 @@ module Aws::CostExplorer
3933
3993
  # @see http://docs.aws.amazon.com/goto/WebAPI/ce-2017-10-25/SavingsPlansPurchaseRecommendation AWS API Documentation
3934
3994
  #
3935
3995
  class SavingsPlansPurchaseRecommendation < Struct.new(
3996
+ :account_scope,
3936
3997
  :savings_plans_type,
3937
3998
  :term_in_years,
3938
3999
  :payment_option,
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-costexplorer
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.37.0
4
+ version: 1.38.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-03-16 00:00:00.000000000 Z
11
+ date: 2020-03-25 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -80,7 +80,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
80
80
  - !ruby/object:Gem::Version
81
81
  version: '0'
82
82
  requirements: []
83
- rubygems_version: 3.0.3
83
+ rubyforge_project:
84
+ rubygems_version: 2.5.2.3
84
85
  signing_key:
85
86
  specification_version: 4
86
87
  summary: AWS SDK for Ruby - AWS Cost Explorer