aws-sdk-savingsplans 1.38.0 → 1.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1162295e9f597076d8cf1416512e6011454a02756cc03320ab6726966c36c423
-  data.tar.gz: ba552d0857c3523c6ca6f23a6df9e4aa57d8425cfa7f278cad0770b4c5812f94
+  metadata.gz: ad8bdf4f784723663b13ceabf9b97d114431690841f011c5c183ea56667857a5
+  data.tar.gz: 705fec4f3a3d58787f05f77be399f89deb0fab291745ac949e2336e55de60dc6
 SHA512:
-  metadata.gz: e52b5549294b5e5cdd052f56d62440ed76ee4f96a5b92a37b4a0d86595147505751a8ee32b53a38a31c20ef6e77414b1d1d5e1703b7bebbfc5078febf4b94321
-  data.tar.gz: d199048343d7b27259c3c00e8467f3eb91ef4888a119b1db49ca2a9743681a629f2755e79eb2fb1230c70b525d11ab78afc596b2ca22ab24de0397535b444210
+  metadata.gz: 8343c66fc2f452690a120587c2de431d27c2f587dc1375410acd56f2405c9b1f0bee0012e903eb1dad9fdb8bfdae5964cd90215ebc9fc3a2cac0ee4bf40e31df
+  data.tar.gz: 31926d4f284d1f47ff84ec41e2d2cd97a267b9ff97fb78770a5c58fe8768add36fdfa5da26c21396fe93cde5817008b5bf9f4923ef8754e94553d6d6d836d5ed

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.40.0 (2024-04-25)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+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.40.0

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

@@ -22,6 +22,7 @@ require 'aws-sdk-core/plugins/endpoint_pattern.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
+require 'aws-sdk-core/plugins/invocation_id.rb'
 require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
@@ -72,6 +73,7 @@ module Aws::SavingsPlans
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
+    add_plugin(Aws::Plugins::InvocationId)
     add_plugin(Aws::Plugins::JsonvalueConverter)
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
@@ -196,10 +198,17 @@ module Aws::SavingsPlans
     #     When set to 'true' the request body will not be compressed
     #     for supported operations.
     #
-    #   @option options [String] :endpoint
-    #     The client endpoint is normally constructed from the `:region`
-    #     option. You should only configure an `:endpoint` when connecting
-    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
+    #   @option options [String, URI::HTTPS, URI::HTTP] :endpoint
+    #     Normally you should not configure the `:endpoint` option
+    #     directly. This is normally constructed from the `:region`
+    #     option. Configuring `:endpoint` is normally reserved for
+    #     connecting to test or custom endpoints. The endpoint should
+    #     be a URI formatted like:
+    #
+    #         'http://example.com'
+    #         'https://example.com'
+    #         'http://example.com:123'
+    #
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -337,50 +346,65 @@ module Aws::SavingsPlans
     #   @option options [Aws::SavingsPlans::EndpointProvider] :endpoint_provider
     #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::SavingsPlans::EndpointParameters`
     #
-    #   @option options [URI::HTTP,String] :http_proxy A proxy to send
-    #     requests through.  Formatted like 'http://proxy.com:123'.
-    #
-    #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before raising a
-    #     `Timeout::Error`.
-    #
-    #   @option options [Float] :http_read_timeout (60) The default
-    #     number of seconds to wait for response data.  This value can
-    #     safely be set per-request on the session.
-    #
-    #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idle before it is
-    #     considered stale.  Stale connections are closed and removed
-    #     from the pool before making a request.
-    #
-    #   @option options [Float] :http_continue_timeout (1) The number of
-    #     seconds to wait for a 100-continue response before sending the
-    #     request body.  This option has no effect unless the request has
-    #     "Expect" header set to "100-continue".  Defaults to `nil` which
-    #     disables this behaviour.  This value can safely be set per
-    #     request on the session.
-    #
-    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
-    #     in seconds.
-    #
-    #   @option options [Boolean] :http_wire_trace (false) When `true`,
-    #     HTTP debug output will be sent to the `:logger`.
+    #   @option options [Float] :http_continue_timeout (1)
+    #     The number of seconds to wait for a 100-continue response before sending the
+    #     request body.  This option has no effect unless the request has "Expect"
+    #     header set to "100-continue".  Defaults to `nil` which  disables this
+    #     behaviour.  This value can safely be set per request on the session.
+    #
+    #   @option options [Float] :http_idle_timeout (5)
+    #     The number of seconds a connection is allowed to sit idle before it
+    #     is considered stale.  Stale connections are closed and removed from the
+    #     pool before making a request.
+    #
+    #   @option options [Float] :http_open_timeout (15)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [URI::HTTP,String] :http_proxy
+    #     A proxy to send requests through.  Formatted like 'http://proxy.com:123'.
+    #
+    #   @option options [Float] :http_read_timeout (60)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [Boolean] :http_wire_trace (false)
+    #     When `true`,  HTTP debug output will be sent to the `:logger`.
+    #
+    #   @option options [Proc] :on_chunk_received
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the response body is received. It provides three arguments: the chunk,
+    #     the number of bytes received, and the total number of
+    #     bytes in the response (or nil if the server did not send a `content-length`).
+    #
+    #   @option options [Proc] :on_chunk_sent
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the request body is sent. It provides three arguments: the chunk,
+    #     the number of bytes read from the body, and the total number of
+    #     bytes in the body.
+    #
+    #   @option options [Boolean] :raise_response_errors (true)
+    #     When `true`, response errors are raised.
+    #
+    #   @option options [String] :ssl_ca_bundle
+    #     Full path to the SSL certificate authority bundle file that should be used when
+    #     verifying peer certificates.  If you do not pass `:ssl_ca_bundle` or
+    #     `:ssl_ca_directory` the the system default will be used if available.
+    #
+    #   @option options [String] :ssl_ca_directory
+    #     Full path of the directory that contains the unbundled SSL certificate
+    #     authority files for verifying peer certificates.  If you do
+    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system
+    #     default will be used if available.
     #
-    #   @option options [Boolean] :ssl_verify_peer (true) When `true`,
-    #     SSL peer certificates are verified when establishing a
-    #     connection.
+    #   @option options [String] :ssl_ca_store
+    #     Sets the X509::Store to verify peer certificate.
     #
-    #   @option options [String] :ssl_ca_bundle Full path to the SSL
-    #     certificate authority bundle file that should be used when
-    #     verifying peer certificates.  If you do not pass
-    #     `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
-    #     will be used if available.
+    #   @option options [Float] :ssl_timeout
+    #     Sets the SSL timeout in seconds
     #
-    #   @option options [String] :ssl_ca_directory Full path of the
-    #     directory that contains the unbundled SSL certificate
-    #     authority files for verifying peer certificates.  If you do
-    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
-    #     system default will be used if available.
+    #   @option options [Boolean] :ssl_verify_peer (true)
+    #     When `true`, SSL peer certificates are verified when establishing a connection.
     #
     def initialize(*args)
       super
@@ -394,21 +418,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 +493,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 +571,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 +588,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 +606,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 +620,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 +632,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 +644,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 +653,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 +721,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 +733,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 +751,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 +850,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 +954,7 @@ module Aws::SavingsPlans
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-savingsplans'
-      context[:gem_version] = '1.38.0'
+      context[:gem_version] = '1.40.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.40.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.40.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-01-26 00:00:00.000000000 Z
+date: 2024-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.191.0
+        version: 3.193.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.191.0
+        version: 3.193.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement