aws-sdk-savingsplans 1.38.0 → 1.39.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1162295e9f597076d8cf1416512e6011454a02756cc03320ab6726966c36c423
-  data.tar.gz: ba552d0857c3523c6ca6f23a6df9e4aa57d8425cfa7f278cad0770b4c5812f94
+  metadata.gz: 2d92b8d4b25734c04293ad0e0883dbbfb3fd747f83c6cbff80a719a1cacee75e
+  data.tar.gz: 842efd2ef6bd07f3897f694de0df118ac7526e58d876de7be3a69a23e93c3e03
 SHA512:
-  metadata.gz: e52b5549294b5e5cdd052f56d62440ed76ee4f96a5b92a37b4a0d86595147505751a8ee32b53a38a31c20ef6e77414b1d1d5e1703b7bebbfc5078febf4b94321
-  data.tar.gz: d199048343d7b27259c3c00e8467f3eb91ef4888a119b1db49ca2a9743681a629f2755e79eb2fb1230c70b525d11ab78afc596b2ca22ab24de0397535b444210
+  metadata.gz: afc35e188dc62e8c02626f33721b4f5f73db5d062f050d2bd9c9b4aa59a7d830b4f6337c8e64e552d52b320436a728c8962d018ce4830670b3cf7732a60c428c
+  data.tar.gz: ec9bcc746ed07ad90dde35659bf60301d7ab722aec0693b95f38bd25252518983aea2aafb5f832de8fbd22d18a19ca14c133d4079bdb6e5e55db04b51eb336c6

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.39.0 (2024-03-20)
+------------------
+
+* Feature - Introducing the Savings Plans Return feature enabling customers to return their Savings Plans within 7 days of purchase.
+
 1.38.0 (2024-01-26)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.38.0
+1.39.0

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

@@ -394,21 +394,21 @@ module Aws::SavingsPlans
     #   The ID of the offering.
     #
     # @option params [required, String] :commitment
-    #   The hourly commitment, in USD. This is a value between 0.001 and 1
-    #   million. You cannot specify more than five digits after the decimal
-    #   point.
+    #   The hourly commitment, in the same currency of the
+    #   `savingsPlanOfferingId`. This is a value between 0.001 and 1 million.
+    #   You cannot specify more than five digits after the decimal point.
     #
     # @option params [String] :upfront_payment_amount
     #   The up-front payment amount. This is a whole number between 50 and 99
-    #   percent of the total value of the Savings Plan. This parameter is
-    #   supported only if the payment option is `Partial Upfront`.
+    #   percent of the total value of the Savings Plan. This parameter is only
+    #   supported if the payment option is `Partial Upfront`.
     #
     # @option params [Time,DateTime,Date,Integer,String] :purchase_time
-    #   The time at which to purchase the Savings Plan, in UTC format
+    #   The purchase time of the Savings Plan in UTC format
     #   (YYYY-MM-DDTHH:MM:SSZ).
     #
     # @option params [String] :client_token
-    #   Unique, case-sensitive identifier that you provide to ensure the
+    #   A unique, case-sensitive identifier that you provide to ensure the
     #   idempotency of the request.
     #
     #   **A suitable default value is auto-generated.** You should normally
@@ -469,7 +469,7 @@ module Aws::SavingsPlans
       req.send_request(options)
     end
 
-    # Describes the specified Savings Plans rates.
+    # Describes the rates for the specified Savings Plan.
     #
     # @option params [required, String] :savings_plan_id
     #   The ID of the Savings Plan.
@@ -547,7 +547,7 @@ module Aws::SavingsPlans
     #   value.
     #
     # @option params [Array<String>] :states
-    #   The states.
+    #   The current states of the Savings Plans.
     #
     # @option params [Array<Types::SavingsPlanFilter>] :filters
     #   The filters.
@@ -564,7 +564,7 @@ module Aws::SavingsPlans
     #     savings_plan_ids: ["SavingsPlanId"],
     #     next_token: "PaginationToken",
     #     max_results: 1,
-    #     states: ["payment-pending"], # accepts payment-pending, payment-failed, active, retired, queued, queued-deleted
+    #     states: ["payment-pending"], # accepts payment-pending, payment-failed, active, retired, queued, queued-deleted, pending-return, returned
     #     filters: [
     #       {
     #         name: "region", # accepts region, ec2-instance-family, commitment, upfront, term, savings-plan-type, payment-option, start, end
@@ -582,7 +582,7 @@ module Aws::SavingsPlans
     #   resp.savings_plans[0].description #=> String
     #   resp.savings_plans[0].start #=> String
     #   resp.savings_plans[0].end #=> String
-    #   resp.savings_plans[0].state #=> String, one of "payment-pending", "payment-failed", "active", "retired", "queued", "queued-deleted"
+    #   resp.savings_plans[0].state #=> String, one of "payment-pending", "payment-failed", "active", "retired", "queued", "queued-deleted", "pending-return", "returned"
     #   resp.savings_plans[0].region #=> String
     #   resp.savings_plans[0].ec2_instance_family #=> String
     #   resp.savings_plans[0].savings_plan_type #=> String, one of "Compute", "EC2Instance", "SageMaker"
@@ -596,6 +596,7 @@ module Aws::SavingsPlans
     #   resp.savings_plans[0].term_duration_in_seconds #=> Integer
     #   resp.savings_plans[0].tags #=> Hash
     #   resp.savings_plans[0].tags["TagKey"] #=> String
+    #   resp.savings_plans[0].returnable_until #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/savingsplans-2019-06-28/DescribeSavingsPlans AWS API Documentation
@@ -607,7 +608,7 @@ module Aws::SavingsPlans
       req.send_request(options)
     end
 
-    # Describes the specified Savings Plans offering rates.
+    # Describes the offering rates for the specified Savings Plans.
     #
     # @option params [Array<String>] :savings_plan_offering_ids
     #   The IDs of the offerings.
@@ -619,7 +620,7 @@ module Aws::SavingsPlans
     #   The plan types.
     #
     # @option params [Array<String>] :products
-    #   The AWS products.
+    #   The Amazon Web Services products.
     #
     # @option params [Array<String>] :service_codes
     #   The services.
@@ -628,7 +629,8 @@ module Aws::SavingsPlans
     #   The usage details of the line item in the billing report.
     #
     # @option params [Array<String>] :operations
-    #   The specific AWS operation for the line item in the billing report.
+    #   The specific Amazon Web Services operation for the line item in the
+    #   billing report.
     #
     # @option params [Array<Types::SavingsPlanOfferingRateFilterElement>] :filters
     #   The filters.
@@ -695,7 +697,7 @@ module Aws::SavingsPlans
       req.send_request(options)
     end
 
-    # Describes the specified Savings Plans offerings.
+    # Describes the offerings for the specified Savings Plans.
     #
     # @option params [Array<String>] :offering_ids
     #   The IDs of the offerings.
@@ -707,10 +709,10 @@ module Aws::SavingsPlans
     #   The product type.
     #
     # @option params [Array<String>] :plan_types
-    #   The plan type.
+    #   The plan types.
     #
     # @option params [Array<Integer>] :durations
-    #   The durations, in seconds.
+    #   The duration, in seconds.
     #
     # @option params [Array<String>] :currencies
     #   The currencies.
@@ -725,7 +727,8 @@ module Aws::SavingsPlans
     #   The usage details of the line item in the billing report.
     #
     # @option params [Array<String>] :operations
-    #   The specific AWS operation for the line item in the billing report.
+    #   The specific Amazon Web Services operation for the line item in the
+    #   billing report.
     #
     # @option params [Array<Types::SavingsPlanOfferingFilterElement>] :filters
     #   The filters.
@@ -823,6 +826,42 @@ module Aws::SavingsPlans
       req.send_request(options)
     end
 
+    # Returns the specified Savings Plan.
+    #
+    # @option params [required, String] :savings_plan_id
+    #   The ID of the Savings Plan.
+    #
+    # @option params [String] :client_token
+    #   A unique, case-sensitive identifier that you provide to ensure the
+    #   idempotency of the request.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    # @return [Types::ReturnSavingsPlanResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ReturnSavingsPlanResponse#savings_plan_id #savings_plan_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.return_savings_plan({
+    #     savings_plan_id: "SavingsPlanId", # required
+    #     client_token: "ClientToken",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.savings_plan_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/savingsplans-2019-06-28/ReturnSavingsPlan AWS API Documentation
+    #
+    # @overload return_savings_plan(params = {})
+    # @param [Hash] params ({})
+    def return_savings_plan(params = {}, options = {})
+      req = build_request(:return_savings_plan, params)
+      req.send_request(options)
+    end
+
     # Adds the specified tags to the specified resource.
     #
     # @option params [required, String] :resource_arn
@@ -891,7 +930,7 @@ module Aws::SavingsPlans
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-savingsplans'
-      context[:gem_version] = '1.38.0'
+      context[:gem_version] = '1.39.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -44,6 +44,8 @@ module Aws::SavingsPlans
     ParentSavingsPlanOffering = Shapes::StructureShape.new(name: 'ParentSavingsPlanOffering')
     Region = Shapes::StringShape.new(name: 'Region')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
+    ReturnSavingsPlanRequest = Shapes::StructureShape.new(name: 'ReturnSavingsPlanRequest')
+    ReturnSavingsPlanResponse = Shapes::StructureShape.new(name: 'ReturnSavingsPlanResponse')
     SavingsPlan = Shapes::StructureShape.new(name: 'SavingsPlan')
     SavingsPlanArn = Shapes::StringShape.new(name: 'SavingsPlanArn')
     SavingsPlanArnList = Shapes::ListShape.new(name: 'SavingsPlanArnList')
@@ -219,6 +221,13 @@ module Aws::SavingsPlans
     ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message"))
     ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
 
+    ReturnSavingsPlanRequest.add_member(:savings_plan_id, Shapes::ShapeRef.new(shape: SavingsPlanId, required: true, location_name: "savingsPlanId"))
+    ReturnSavingsPlanRequest.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "clientToken", metadata: {"idempotencyToken"=>true}))
+    ReturnSavingsPlanRequest.struct_class = Types::ReturnSavingsPlanRequest
+
+    ReturnSavingsPlanResponse.add_member(:savings_plan_id, Shapes::ShapeRef.new(shape: SavingsPlanId, location_name: "savingsPlanId"))
+    ReturnSavingsPlanResponse.struct_class = Types::ReturnSavingsPlanResponse
+
     SavingsPlan.add_member(:offering_id, Shapes::ShapeRef.new(shape: SavingsPlanOfferingId, location_name: "offeringId"))
     SavingsPlan.add_member(:savings_plan_id, Shapes::ShapeRef.new(shape: SavingsPlanId, location_name: "savingsPlanId"))
     SavingsPlan.add_member(:savings_plan_arn, Shapes::ShapeRef.new(shape: SavingsPlanArn, location_name: "savingsPlanArn"))
@@ -237,6 +246,7 @@ module Aws::SavingsPlans
     SavingsPlan.add_member(:recurring_payment_amount, Shapes::ShapeRef.new(shape: Amount, location_name: "recurringPaymentAmount"))
     SavingsPlan.add_member(:term_duration_in_seconds, Shapes::ShapeRef.new(shape: TermDurationInSeconds, location_name: "termDurationInSeconds"))
     SavingsPlan.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
+    SavingsPlan.add_member(:returnable_until, Shapes::ShapeRef.new(shape: String, location_name: "returnableUntil"))
     SavingsPlan.struct_class = Types::SavingsPlan
 
     SavingsPlanArnList.member = Shapes::ShapeRef.new(shape: SavingsPlanArn)
@@ -467,6 +477,18 @@ module Aws::SavingsPlans
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 
+      api.add_operation(:return_savings_plan, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ReturnSavingsPlan"
+        o.http_method = "POST"
+        o.http_request_uri = "/ReturnSavingsPlan"
+        o.input = Shapes::ShapeRef.new(shape: ReturnSavingsPlanRequest)
+        o.output = Shapes::ShapeRef.new(shape: ReturnSavingsPlanResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
+      end)
+
       api.add_operation(:tag_resource, Seahorse::Model::Operation.new.tap do |o|
         o.name = "TagResource"
         o.http_method = "POST"

data/lib/aws-sdk-savingsplans/endpoint_provider.rb

@@ -35,7 +35,7 @@ module Aws::SavingsPlans
             raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
           end
           if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+            if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
               return Aws::Endpoints::Endpoint.new(url: "https://savingsplans-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
             end
             raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"

data/lib/aws-sdk-savingsplans/endpoints.rb

@@ -110,6 +110,20 @@ module Aws::SavingsPlans
       end
     end
 
+    class ReturnSavingsPlan
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::SavingsPlans::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class TagResource
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-savingsplans/plugins/endpoints.rb

@@ -72,6 +72,8 @@ module Aws::SavingsPlans
             Aws::SavingsPlans::Endpoints::DescribeSavingsPlansOfferings.build(context)
           when :list_tags_for_resource
             Aws::SavingsPlans::Endpoints::ListTagsForResource.build(context)
+          when :return_savings_plan
+            Aws::SavingsPlans::Endpoints::ReturnSavingsPlan.build(context)
           when :tag_resource
             Aws::SavingsPlans::Endpoints::TagResource.build(context)
           when :untag_resource

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

@@ -15,7 +15,8 @@ module Aws::SavingsPlans
     #   @return [String]
     #
     # @!attribute [rw] commitment
-    #   The hourly commitment, in USD. This is a value between 0.001 and 1
+    #   The hourly commitment, in the same currency of the
+    #   `savingsPlanOfferingId`. This is a value between 0.001 and 1
     #   million. You cannot specify more than five digits after the decimal
     #   point.
     #   @return [String]
@@ -23,16 +24,16 @@ module Aws::SavingsPlans
     # @!attribute [rw] upfront_payment_amount
     #   The up-front payment amount. This is a whole number between 50 and
     #   99 percent of the total value of the Savings Plan. This parameter is
-    #   supported only if the payment option is `Partial Upfront`.
+    #   only supported if the payment option is `Partial Upfront`.
     #   @return [String]
     #
     # @!attribute [rw] purchase_time
-    #   The time at which to purchase the Savings Plan, in UTC format
+    #   The purchase time of the Savings Plan in UTC format
     #   (YYYY-MM-DDTHH:MM:SSZ).
     #   @return [Time]
     #
     # @!attribute [rw] client_token
-    #   Unique, case-sensitive identifier that you provide to ensure the
+    #   A unique, case-sensitive identifier that you provide to ensure the
     #   idempotency of the request.
     #
     #   **A suitable default value is auto-generated.** You should normally
@@ -118,7 +119,7 @@ module Aws::SavingsPlans
     #   @return [String]
     #
     # @!attribute [rw] search_results
-    #   Information about the Savings Plans rates.
+    #   Information about the Savings Plan rates.
     #   @return [Array<Types::SavingsPlanRate>]
     #
     # @!attribute [rw] next_token
@@ -149,7 +150,7 @@ module Aws::SavingsPlans
     #   @return [Array<String>]
     #
     # @!attribute [rw] products
-    #   The AWS products.
+    #   The Amazon Web Services products.
     #   @return [Array<String>]
     #
     # @!attribute [rw] service_codes
@@ -161,7 +162,8 @@ module Aws::SavingsPlans
     #   @return [Array<String>]
     #
     # @!attribute [rw] operations
-    #   The specific AWS operation for the line item in the billing report.
+    #   The specific Amazon Web Services operation for the line item in the
+    #   billing report.
     #   @return [Array<String>]
     #
     # @!attribute [rw] filters
@@ -226,11 +228,11 @@ module Aws::SavingsPlans
     #   @return [String]
     #
     # @!attribute [rw] plan_types
-    #   The plan type.
+    #   The plan types.
     #   @return [Array<String>]
     #
     # @!attribute [rw] durations
-    #   The durations, in seconds.
+    #   The duration, in seconds.
     #   @return [Array<Integer>]
     #
     # @!attribute [rw] currencies
@@ -250,7 +252,8 @@ module Aws::SavingsPlans
     #   @return [Array<String>]
     #
     # @!attribute [rw] operations
-    #   The specific AWS operation for the line item in the billing report.
+    #   The specific Amazon Web Services operation for the line item in the
+    #   billing report.
     #   @return [Array<String>]
     #
     # @!attribute [rw] filters
@@ -324,7 +327,7 @@ module Aws::SavingsPlans
     #   @return [Integer]
     #
     # @!attribute [rw] states
-    #   The states.
+    #   The current states of the Savings Plans.
     #   @return [Array<String>]
     #
     # @!attribute [rw] filters
@@ -451,6 +454,39 @@ module Aws::SavingsPlans
       include Aws::Structure
     end
 
+    # @!attribute [rw] savings_plan_id
+    #   The ID of the Savings Plan.
+    #   @return [String]
+    #
+    # @!attribute [rw] client_token
+    #   A unique, case-sensitive identifier that you provide to ensure the
+    #   idempotency of the request.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/savingsplans-2019-06-28/ReturnSavingsPlanRequest AWS API Documentation
+    #
+    class ReturnSavingsPlanRequest < Struct.new(
+      :savings_plan_id,
+      :client_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] savings_plan_id
+    #   The ID of the Savings Plan.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/savingsplans-2019-06-28/ReturnSavingsPlanResponse AWS API Documentation
+    #
+    class ReturnSavingsPlanResponse < Struct.new(
+      :savings_plan_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Information about a Savings Plan.
     #
     # @!attribute [rw] offering_id
@@ -478,11 +514,11 @@ module Aws::SavingsPlans
     #   @return [String]
     #
     # @!attribute [rw] state
-    #   The state.
+    #   The current state.
     #   @return [String]
     #
     # @!attribute [rw] region
-    #   The AWS Region.
+    #   The Amazon Web Services Region.
     #   @return [String]
     #
     # @!attribute [rw] ec2_instance_family
@@ -506,7 +542,7 @@ module Aws::SavingsPlans
     #   @return [String]
     #
     # @!attribute [rw] commitment
-    #   The hourly commitment, in USD.
+    #   The hourly commitment amount in the specified currency.
     #   @return [String]
     #
     # @!attribute [rw] upfront_payment_amount
@@ -525,6 +561,12 @@ module Aws::SavingsPlans
     #   One or more tags.
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] returnable_until
+    #   The time until when a return for the Savings Plan can be requested.
+    #   If the Savings Plan is not returnable, the field reflects the
+    #   Savings Plan start time.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/savingsplans-2019-06-28/SavingsPlan AWS API Documentation
     #
     class SavingsPlan < Struct.new(
@@ -545,12 +587,13 @@ module Aws::SavingsPlans
       :upfront_payment_amount,
       :recurring_payment_amount,
       :term_duration_in_seconds,
-      :tags)
+      :tags,
+      :returnable_until)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # Information about a filter.
+    # Information about a Savings Plan filter.
     #
     # @!attribute [rw] name
     #   The filter name.
@@ -608,7 +651,8 @@ module Aws::SavingsPlans
     #   @return [String]
     #
     # @!attribute [rw] operation
-    #   The specific AWS operation for the line item in the billing report.
+    #   The specific Amazon Web Services operation for the line item in the
+    #   billing report.
     #   @return [String]
     #
     # @!attribute [rw] properties
@@ -633,7 +677,7 @@ module Aws::SavingsPlans
       include Aws::Structure
     end
 
-    # Information about a filter.
+    # Information about a Savings Plan offering filter.
     #
     # @!attribute [rw] name
     #   The filter name.
@@ -652,7 +696,7 @@ module Aws::SavingsPlans
       include Aws::Structure
     end
 
-    # Information about a property.
+    # Information about a Savings Plan offering property.
     #
     # @!attribute [rw] name
     #   The property name.
@@ -698,7 +742,8 @@ module Aws::SavingsPlans
     #   @return [String]
     #
     # @!attribute [rw] operation
-    #   The specific AWS operation for the line item in the billing report.
+    #   The specific Amazon Web Services operation for the line item in the
+    #   billing report.
     #   @return [String]
     #
     # @!attribute [rw] properties
@@ -720,7 +765,7 @@ module Aws::SavingsPlans
       include Aws::Structure
     end
 
-    # Information about a filter.
+    # Information about a Savings Plan offering rate filter.
     #
     # @!attribute [rw] name
     #   The filter name.
@@ -739,7 +784,7 @@ module Aws::SavingsPlans
       include Aws::Structure
     end
 
-    # Information about a property.
+    # Information about a Savings Plan offering rate property.
     #
     # @!attribute [rw] name
     #   The property name.
@@ -785,7 +830,8 @@ module Aws::SavingsPlans
     #   @return [String]
     #
     # @!attribute [rw] operation
-    #   The specific AWS operation for the line item in the billing report.
+    #   The specific Amazon Web Services operation for the line item in the
+    #   billing report.
     #   @return [String]
     #
     # @!attribute [rw] properties
@@ -807,7 +853,7 @@ module Aws::SavingsPlans
       include Aws::Structure
     end
 
-    # Information about a filter.
+    # Information about a Savings Plan rate filter.
     #
     # @!attribute [rw] name
     #   The filter name.
@@ -826,7 +872,7 @@ module Aws::SavingsPlans
       include Aws::Structure
     end
 
-    # Information about a property.
+    # Information about a Savings Plan rate property.
     #
     # @!attribute [rw] name
     #   The property name.

data/lib/aws-sdk-savingsplans.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-savingsplans/customizations'
 # @!group service
 module Aws::SavingsPlans
 
-  GEM_VERSION = '1.38.0'
+  GEM_VERSION = '1.39.0'
 
 end

data/sig/client.rbs

@@ -127,7 +127,7 @@ module Aws
                                     ?savings_plan_ids: Array[::String],
                                     ?next_token: ::String,
                                     ?max_results: ::Integer,
-                                    ?states: Array[("payment-pending" | "payment-failed" | "active" | "retired" | "queued" | "queued-deleted")],
+                                    ?states: Array[("payment-pending" | "payment-failed" | "active" | "retired" | "queued" | "queued-deleted" | "pending-return" | "returned")],
                                     ?filters: Array[
                                       {
                                         name: ("region" | "ec2-instance-family" | "commitment" | "upfront" | "term" | "savings-plan-type" | "payment-option" | "start" | "end")?,
@@ -200,6 +200,17 @@ module Aws
                                   ) -> _ListTagsForResourceResponseSuccess
                                 | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListTagsForResourceResponseSuccess
 
+      interface _ReturnSavingsPlanResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::ReturnSavingsPlanResponse]
+        def savings_plan_id: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/SavingsPlans/Client.html#return_savings_plan-instance_method
+      def return_savings_plan: (
+                                 savings_plan_id: ::String,
+                                 ?client_token: ::String
+                               ) -> _ReturnSavingsPlanResponseSuccess
+                             | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ReturnSavingsPlanResponseSuccess
+
       interface _TagResourceResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::TagResourceResponse]
       end

data/sig/types.rbs

@@ -94,7 +94,7 @@ module Aws::SavingsPlans
       attr_accessor savings_plan_ids: ::Array[::String]
       attr_accessor next_token: ::String
       attr_accessor max_results: ::Integer
-      attr_accessor states: ::Array[("payment-pending" | "payment-failed" | "active" | "retired" | "queued" | "queued-deleted")]
+      attr_accessor states: ::Array[("payment-pending" | "payment-failed" | "active" | "retired" | "queued" | "queued-deleted" | "pending-return" | "returned")]
       attr_accessor filters: ::Array[Types::SavingsPlanFilter]
       SENSITIVE: []
     end
@@ -135,6 +135,17 @@ module Aws::SavingsPlans
       SENSITIVE: []
     end
 
+    class ReturnSavingsPlanRequest
+      attr_accessor savings_plan_id: ::String
+      attr_accessor client_token: ::String
+      SENSITIVE: []
+    end
+
+    class ReturnSavingsPlanResponse
+      attr_accessor savings_plan_id: ::String
+      SENSITIVE: []
+    end
+
     class SavingsPlan
       attr_accessor offering_id: ::String
       attr_accessor savings_plan_id: ::String
@@ -142,7 +153,7 @@ module Aws::SavingsPlans
       attr_accessor description: ::String
       attr_accessor start: ::String
       attr_accessor end: ::String
-      attr_accessor state: ("payment-pending" | "payment-failed" | "active" | "retired" | "queued" | "queued-deleted")
+      attr_accessor state: ("payment-pending" | "payment-failed" | "active" | "retired" | "queued" | "queued-deleted" | "pending-return" | "returned")
       attr_accessor region: ::String
       attr_accessor ec2_instance_family: ::String
       attr_accessor savings_plan_type: ("Compute" | "EC2Instance" | "SageMaker")
@@ -154,6 +165,7 @@ module Aws::SavingsPlans
       attr_accessor recurring_payment_amount: ::String
       attr_accessor term_duration_in_seconds: ::Integer
       attr_accessor tags: ::Hash[::String, ::String]
+      attr_accessor returnable_until: ::String
       SENSITIVE: []
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-savingsplans
 version: !ruby/object:Gem::Version
-  version: 1.38.0
+  version: 1.39.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-26 00:00:00.000000000 Z
+date: 2024-03-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core