aws-sdk-costoptimizationhub 1.25.0 → 1.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e14ce6643769c97b35fbf2ad9efbb4cf6217b55b27eca57c9358d277e2d1277
-  data.tar.gz: a9b53d25d16b4aec4cd914817da004efdec34660466dfc8b16208f79a3601f41
+  metadata.gz: f84b799c0a0065ddf51f92114290b4aff7796d474b9a3ccc007cf904e558fbb4
+  data.tar.gz: 75c4544076451a72e11c171e73d4b7ad86ac7d0152a91b6cd69fa241fcc9ee11
 SHA512:
-  metadata.gz: 4be7e21dada302e5fefdd5e9e9a4f9957ff44ac442e7cda567e7d2416f79dae75ac5ca0cc5385352fff1a358b434d69fc937d7a40ade56935eb179890db8d0aa
-  data.tar.gz: b8e03bc50a809105274a70d1473899a62900a65163fe8347651d49ca6c300db7d69809f54c7b231bfb4da07abc41b9e8bc40095aff490fd5ae9e16123edff88f
+  metadata.gz: 64204d8ffb604fbbbedab0efcaf5851012fe246e8a2aacbefd7d46319ce0e6dece223b0dfe2cc3d43a6b79c3c7290bfe768009f37fc69469803d4ae52349fb25
+  data.tar.gz: 92ece7d5ccd02c9fdd1ee73df3ffc608bf7c9bc6ae7e8f5094995c7d2aaeb4f0724dbb6dc6e84f40a41c3850b09f6f299c38377535800230b2aa36a16263435d

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.26.0 (2025-05-28)
+------------------
+
+* Feature - This release allows customers to modify their preferred commitment term and payment options.
+
 1.25.0 (2025-05-12)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.25.0
+1.26.0

data/lib/aws-sdk-costoptimizationhub/client.rb

@@ -486,11 +486,14 @@ module Aws::CostOptimizationHub
     #
     #   * {Types::GetPreferencesResponse#savings_estimation_mode #savings_estimation_mode} => String
     #   * {Types::GetPreferencesResponse#member_account_discount_visibility #member_account_discount_visibility} => String
+    #   * {Types::GetPreferencesResponse#preferred_commitment #preferred_commitment} => Types::PreferredCommitment
     #
     # @example Response structure
     #
     #   resp.savings_estimation_mode #=> String, one of "BeforeDiscounts", "AfterDiscounts"
     #   resp.member_account_discount_visibility #=> String, one of "All", "None"
+    #   resp.preferred_commitment.term #=> String, one of "OneYear", "ThreeYears"
+    #   resp.preferred_commitment.payment_option #=> String, one of "AllUpfront", "PartialUpfront", "NoUpfront"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cost-optimization-hub-2022-07-26/GetPreferences AWS API Documentation
     #
@@ -1371,22 +1374,34 @@ module Aws::CostOptimizationHub
     # @option params [String] :member_account_discount_visibility
     #   Sets the "member account discount visibility" preference.
     #
+    # @option params [Types::PreferredCommitment] :preferred_commitment
+    #   Sets the preferences for how Reserved Instances and Savings Plans
+    #   cost-saving opportunities are prioritized in terms of payment option
+    #   and term length.
+    #
     # @return [Types::UpdatePreferencesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdatePreferencesResponse#savings_estimation_mode #savings_estimation_mode} => String
     #   * {Types::UpdatePreferencesResponse#member_account_discount_visibility #member_account_discount_visibility} => String
+    #   * {Types::UpdatePreferencesResponse#preferred_commitment #preferred_commitment} => Types::PreferredCommitment
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_preferences({
     #     savings_estimation_mode: "BeforeDiscounts", # accepts BeforeDiscounts, AfterDiscounts
     #     member_account_discount_visibility: "All", # accepts All, None
+    #     preferred_commitment: {
+    #       term: "OneYear", # accepts OneYear, ThreeYears
+    #       payment_option: "AllUpfront", # accepts AllUpfront, PartialUpfront, NoUpfront
+    #     },
     #   })
     #
     # @example Response structure
     #
     #   resp.savings_estimation_mode #=> String, one of "BeforeDiscounts", "AfterDiscounts"
     #   resp.member_account_discount_visibility #=> String, one of "All", "None"
+    #   resp.preferred_commitment.term #=> String, one of "OneYear", "ThreeYears"
+    #   resp.preferred_commitment.payment_option #=> String, one of "AllUpfront", "PartialUpfront", "NoUpfront"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cost-optimization-hub-2022-07-26/UpdatePreferences AWS API Documentation
     #
@@ -1415,7 +1430,7 @@ module Aws::CostOptimizationHub
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-costoptimizationhub'
-      context[:gem_version] = '1.25.0'
+      context[:gem_version] = '1.26.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-costoptimizationhub/client_api.rb

@@ -79,6 +79,8 @@ module Aws::CostOptimizationHub
     OpenSearchReservedInstancesConfiguration = Shapes::StructureShape.new(name: 'OpenSearchReservedInstancesConfiguration')
     Order = Shapes::StringShape.new(name: 'Order')
     OrderBy = Shapes::StructureShape.new(name: 'OrderBy')
+    PaymentOption = Shapes::StringShape.new(name: 'PaymentOption')
+    PreferredCommitment = Shapes::StructureShape.new(name: 'PreferredCommitment')
     PrimitiveBoolean = Shapes::BooleanShape.new(name: 'PrimitiveBoolean')
     RdsDbInstance = Shapes::StructureShape.new(name: 'RdsDbInstance')
     RdsDbInstanceConfiguration = Shapes::StructureShape.new(name: 'RdsDbInstanceConfiguration')
@@ -117,6 +119,7 @@ module Aws::CostOptimizationHub
     SummaryMetricsResult = Shapes::StructureShape.new(name: 'SummaryMetricsResult')
     Tag = Shapes::StructureShape.new(name: 'Tag')
     TagList = Shapes::ListShape.new(name: 'TagList')
+    Term = Shapes::StringShape.new(name: 'Term')
     ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
     Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
     UpdateEnrollmentStatusRequest = Shapes::StructureShape.new(name: 'UpdateEnrollmentStatusRequest')
@@ -291,6 +294,7 @@ module Aws::CostOptimizationHub
 
     GetPreferencesResponse.add_member(:savings_estimation_mode, Shapes::ShapeRef.new(shape: SavingsEstimationMode, location_name: "savingsEstimationMode"))
     GetPreferencesResponse.add_member(:member_account_discount_visibility, Shapes::ShapeRef.new(shape: MemberAccountDiscountVisibility, location_name: "memberAccountDiscountVisibility"))
+    GetPreferencesResponse.add_member(:preferred_commitment, Shapes::ShapeRef.new(shape: PreferredCommitment, location_name: "preferredCommitment"))
     GetPreferencesResponse.struct_class = Types::GetPreferencesResponse
 
     GetRecommendationRequest.add_member(:recommendation_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "recommendationId"))
@@ -419,6 +423,10 @@ module Aws::CostOptimizationHub
     OrderBy.add_member(:order, Shapes::ShapeRef.new(shape: Order, location_name: "order"))
     OrderBy.struct_class = Types::OrderBy
 
+    PreferredCommitment.add_member(:term, Shapes::ShapeRef.new(shape: Term, location_name: "term"))
+    PreferredCommitment.add_member(:payment_option, Shapes::ShapeRef.new(shape: PaymentOption, location_name: "paymentOption"))
+    PreferredCommitment.struct_class = Types::PreferredCommitment
+
     RdsDbInstance.add_member(:configuration, Shapes::ShapeRef.new(shape: RdsDbInstanceConfiguration, location_name: "configuration"))
     RdsDbInstance.add_member(:cost_calculation, Shapes::ShapeRef.new(shape: ResourceCostCalculation, location_name: "costCalculation"))
     RdsDbInstance.struct_class = Types::RdsDbInstance
@@ -627,10 +635,12 @@ module Aws::CostOptimizationHub
 
     UpdatePreferencesRequest.add_member(:savings_estimation_mode, Shapes::ShapeRef.new(shape: SavingsEstimationMode, location_name: "savingsEstimationMode"))
     UpdatePreferencesRequest.add_member(:member_account_discount_visibility, Shapes::ShapeRef.new(shape: MemberAccountDiscountVisibility, location_name: "memberAccountDiscountVisibility"))
+    UpdatePreferencesRequest.add_member(:preferred_commitment, Shapes::ShapeRef.new(shape: PreferredCommitment, location_name: "preferredCommitment"))
     UpdatePreferencesRequest.struct_class = Types::UpdatePreferencesRequest
 
     UpdatePreferencesResponse.add_member(:savings_estimation_mode, Shapes::ShapeRef.new(shape: SavingsEstimationMode, location_name: "savingsEstimationMode"))
     UpdatePreferencesResponse.add_member(:member_account_discount_visibility, Shapes::ShapeRef.new(shape: MemberAccountDiscountVisibility, location_name: "memberAccountDiscountVisibility"))
+    UpdatePreferencesResponse.add_member(:preferred_commitment, Shapes::ShapeRef.new(shape: PreferredCommitment, location_name: "preferredCommitment"))
     UpdatePreferencesResponse.struct_class = Types::UpdatePreferencesResponse
 
     Usage.add_member(:usage_type, Shapes::ShapeRef.new(shape: String, location_name: "usageType"))

data/lib/aws-sdk-costoptimizationhub/types.rb

@@ -795,11 +795,18 @@ module Aws::CostOptimizationHub
     #   preference.
     #   @return [String]
     #
+    # @!attribute [rw] preferred_commitment
+    #   Retrieves the current preferences for how Reserved Instances and
+    #   Savings Plans cost-saving opportunities are prioritized in terms of
+    #   payment option and term length.
+    #   @return [Types::PreferredCommitment]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cost-optimization-hub-2022-07-26/GetPreferencesResponse AWS API Documentation
     #
     class GetPreferencesResponse < Struct.new(
       :savings_estimation_mode,
-      :member_account_discount_visibility)
+      :member_account_discount_visibility,
+      :preferred_commitment)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1184,8 +1191,9 @@ module Aws::CostOptimizationHub
 
     # The MemoryDB reserved instances recommendation details.
     #
-    # <note markdown="1"> MemoryDB reserved instances are referred to as "MemoryDB reserved
-    # nodes" in customer-facing documentation.
+    # <note markdown="1"> While the API reference uses "MemoryDB reserved instances", the user
+    # guide and other documentation refer to them as "MemoryDB reserved
+    # nodes", as the terms are used interchangeably.
     #
     #  </note>
     #
@@ -1210,8 +1218,9 @@ module Aws::CostOptimizationHub
     # The MemoryDB reserved instances configuration used for
     # recommendations.
     #
-    # <note markdown="1"> MemoryDB reserved instances are referred to as "MemoryDB reserved
-    # nodes" in customer-facing documentation.
+    # <note markdown="1"> While the API reference uses "MemoryDB reserved instances", the user
+    # guide and other documentation refer to them as "MemoryDB reserved
+    # nodes", as the terms are used interchangeably.
     #
     #  </note>
     #
@@ -1419,6 +1428,30 @@ module Aws::CostOptimizationHub
       include Aws::Structure
     end
 
+    # The preferred configuration for Reserved Instances and Savings Plans
+    # commitment-based discounts, consisting of a payment option and a
+    # commitment duration.
+    #
+    # @!attribute [rw] term
+    #   The preferred length of the commitment period. If the value is null,
+    #   it will default to `ThreeYears` (highest savings) where applicable.
+    #   @return [String]
+    #
+    # @!attribute [rw] payment_option
+    #   The preferred upfront payment structure for commitments. If the
+    #   value is null, it will default to `AllUpfront` (highest savings)
+    #   where applicable.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/cost-optimization-hub-2022-07-26/PreferredCommitment AWS API Documentation
+    #
+    class PreferredCommitment < Struct.new(
+      :term,
+      :payment_option)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains the details of an Amazon RDS DB instance.
     #
     # @!attribute [rw] configuration
@@ -2299,11 +2332,18 @@ module Aws::CostOptimizationHub
     #   Sets the "member account discount visibility" preference.
     #   @return [String]
     #
+    # @!attribute [rw] preferred_commitment
+    #   Sets the preferences for how Reserved Instances and Savings Plans
+    #   cost-saving opportunities are prioritized in terms of payment option
+    #   and term length.
+    #   @return [Types::PreferredCommitment]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cost-optimization-hub-2022-07-26/UpdatePreferencesRequest AWS API Documentation
     #
     class UpdatePreferencesRequest < Struct.new(
       :savings_estimation_mode,
-      :member_account_discount_visibility)
+      :member_account_discount_visibility,
+      :preferred_commitment)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2317,11 +2357,18 @@ module Aws::CostOptimizationHub
     #   preference.
     #   @return [String]
     #
+    # @!attribute [rw] preferred_commitment
+    #   Shows the updated preferences for how Reserved Instances and Savings
+    #   Plans cost-saving opportunities are prioritized in terms of payment
+    #   option and term length.
+    #   @return [Types::PreferredCommitment]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/cost-optimization-hub-2022-07-26/UpdatePreferencesResponse AWS API Documentation
     #
     class UpdatePreferencesResponse < Struct.new(
       :savings_estimation_mode,
-      :member_account_discount_visibility)
+      :member_account_discount_visibility,
+      :preferred_commitment)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-costoptimizationhub.rb

@@ -55,7 +55,7 @@ module Aws::CostOptimizationHub
   autoload :EndpointProvider, 'aws-sdk-costoptimizationhub/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-costoptimizationhub/endpoints'
 
-  GEM_VERSION = '1.25.0'
+  GEM_VERSION = '1.26.0'
 
 end
 

data/sig/client.rbs

@@ -82,6 +82,7 @@ module Aws
         include ::Seahorse::Client::_ResponseSuccess[Types::GetPreferencesResponse]
         def savings_estimation_mode: () -> ("BeforeDiscounts" | "AfterDiscounts")
         def member_account_discount_visibility: () -> ("All" | "None")
+        def preferred_commitment: () -> Types::PreferredCommitment
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CostOptimizationHub/Client.html#get_preferences-instance_method
       def get_preferences: (
@@ -221,11 +222,16 @@ module Aws
         include ::Seahorse::Client::_ResponseSuccess[Types::UpdatePreferencesResponse]
         def savings_estimation_mode: () -> ("BeforeDiscounts" | "AfterDiscounts")
         def member_account_discount_visibility: () -> ("All" | "None")
+        def preferred_commitment: () -> Types::PreferredCommitment
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CostOptimizationHub/Client.html#update_preferences-instance_method
       def update_preferences: (
                                 ?savings_estimation_mode: ("BeforeDiscounts" | "AfterDiscounts"),
-                                ?member_account_discount_visibility: ("All" | "None")
+                                ?member_account_discount_visibility: ("All" | "None"),
+                                ?preferred_commitment: {
+                                  term: ("OneYear" | "ThreeYears")?,
+                                  payment_option: ("AllUpfront" | "PartialUpfront" | "NoUpfront")?
+                                }
                               ) -> _UpdatePreferencesResponseSuccess
                             | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdatePreferencesResponseSuccess
     end

data/sig/types.rbs

@@ -215,6 +215,7 @@ module Aws::CostOptimizationHub
     class GetPreferencesResponse
       attr_accessor savings_estimation_mode: ("BeforeDiscounts" | "AfterDiscounts")
       attr_accessor member_account_discount_visibility: ("All" | "None")
+      attr_accessor preferred_commitment: Types::PreferredCommitment
       SENSITIVE: []
     end
 
@@ -376,6 +377,12 @@ module Aws::CostOptimizationHub
       SENSITIVE: []
     end
 
+    class PreferredCommitment
+      attr_accessor term: ("OneYear" | "ThreeYears")
+      attr_accessor payment_option: ("AllUpfront" | "PartialUpfront" | "NoUpfront")
+      SENSITIVE: []
+    end
+
     class RdsDbInstance
       attr_accessor configuration: Types::RdsDbInstanceConfiguration
       attr_accessor cost_calculation: Types::ResourceCostCalculation
@@ -638,12 +645,14 @@ module Aws::CostOptimizationHub
     class UpdatePreferencesRequest
       attr_accessor savings_estimation_mode: ("BeforeDiscounts" | "AfterDiscounts")
       attr_accessor member_account_discount_visibility: ("All" | "None")
+      attr_accessor preferred_commitment: Types::PreferredCommitment
       SENSITIVE: []
     end
 
     class UpdatePreferencesResponse
       attr_accessor savings_estimation_mode: ("BeforeDiscounts" | "AfterDiscounts")
       attr_accessor member_account_discount_visibility: ("All" | "None")
+      attr_accessor preferred_commitment: Types::PreferredCommitment
       SENSITIVE: []
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-costoptimizationhub
 version: !ruby/object:Gem::Version
-  version: 1.25.0
+  version: 1.26.0
 platform: ruby
 authors:
 - Amazon Web Services