aws-sdk-appstream 1.130.0 → 1.131.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5103c3fa612becad412d4884ef50383325779713ab4531de89e0c2d2618597d
-  data.tar.gz: 9fe9ffdc7267d8c4dc00476d425d317650658ef954320d6c816a2d32c363fc53
+  metadata.gz: 5a26f042aea6032b67ee04038b1137f439fe67f481ea88c0185e8531302994fe
+  data.tar.gz: 5e87ad0442786fc0255503e3efbbde8512724470eec7b8d1d09ee8cbb24f7aea
 SHA512:
-  metadata.gz: ebf0643008138c350c96cfb16c2bcd42f44356765efe7684569ceccf1612dab49c33f503a12a5118c1340dc80016a83f99a24259794f545a33238e33fee0ffa9
-  data.tar.gz: 5091b75268259a0f0dc966ab2688bbb392eaf42328a5932c42bf3f54f853988dce1645e5bc89b6612c945ac8ed31d379e51fe14b9f5cf22fc663dedbd58185e1
+  metadata.gz: cfd316837e473b580f20947ba33373bdcf12ea212ffe8dbc2f2ea6b827adec53ae2f10af25516aabc340d411f0c78d5401ce31bdbdba0c626ac5e405bc07a86e
+  data.tar.gz: 4a16c3c005b2f268db00e0865be250097a26204ec40bbdb28b2c07408075ce8f4bf9cf0cc59d6653ea1433086d047be4c41d488592c635adb81400c2c963bc5a

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.131.0 (2026-04-02)
+------------------
+
+* Feature - Amazon WorkSpaces Applications now supports drain mode for instances in multi-session fleets. This capability allows administrators to instruct individual fleet instances to stop accepting new user sessions while allowing existing sessions to continue uninterrupted.
+
 1.130.0 (2026-03-30)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.130.0
+1.131.0

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

@@ -1768,6 +1768,9 @@ module Aws::AppStream
     #   resp.fleet.compute_capacity_status.available_user_sessions #=> Integer
     #   resp.fleet.compute_capacity_status.active_user_sessions #=> Integer
     #   resp.fleet.compute_capacity_status.actual_user_sessions #=> Integer
+    #   resp.fleet.compute_capacity_status.draining #=> Integer
+    #   resp.fleet.compute_capacity_status.drain_mode_active_user_sessions #=> Integer
+    #   resp.fleet.compute_capacity_status.drain_mode_unused_user_sessions #=> Integer
     #   resp.fleet.max_user_duration_in_seconds #=> Integer
     #   resp.fleet.disconnect_timeout_in_seconds #=> Integer
     #   resp.fleet.state #=> String, one of "STARTING", "RUNNING", "STOPPING", "STOPPED"
@@ -3768,6 +3771,9 @@ module Aws::AppStream
     #   resp.fleets[0].compute_capacity_status.available_user_sessions #=> Integer
     #   resp.fleets[0].compute_capacity_status.active_user_sessions #=> Integer
     #   resp.fleets[0].compute_capacity_status.actual_user_sessions #=> Integer
+    #   resp.fleets[0].compute_capacity_status.draining #=> Integer
+    #   resp.fleets[0].compute_capacity_status.drain_mode_active_user_sessions #=> Integer
+    #   resp.fleets[0].compute_capacity_status.drain_mode_unused_user_sessions #=> Integer
     #   resp.fleets[0].max_user_duration_in_seconds #=> Integer
     #   resp.fleets[0].disconnect_timeout_in_seconds #=> Integer
     #   resp.fleets[0].state #=> String, one of "STARTING", "RUNNING", "STOPPING", "STOPPED"
@@ -4104,6 +4110,7 @@ module Aws::AppStream
     #   resp.sessions[0].network_access_configuration.eni_ipv_6_addresses[0] #=> String
     #   resp.sessions[0].network_access_configuration.eni_id #=> String
     #   resp.sessions[0].instance_id #=> String
+    #   resp.sessions[0].instance_drain_status #=> String, one of "ACTIVE", "DRAINING", "NOT_APPLICABLE"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appstream-2016-12-01/DescribeSessions AWS API Documentation
@@ -4646,6 +4653,31 @@ module Aws::AppStream
       req.send_request(options)
     end
 
+    # Drains the instance hosting the specified streaming session. The
+    # instance stops accepting new sessions while existing sessions continue
+    # uninterrupted. Once all sessions end, the instance is reclaimed and
+    # replaced. This only applies to multi-session fleets.
+    #
+    # @option params [required, String] :session_id
+    #   The identifier of the streaming session.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.drain_session_instance({
+    #     session_id: "String", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appstream-2016-12-01/DrainSessionInstance AWS API Documentation
+    #
+    # @overload drain_session_instance(params = {})
+    # @param [Hash] params ({})
+    def drain_session_instance(params = {}, options = {})
+      req = build_request(:drain_session_instance, params)
+      req.send_request(options)
+    end
+
     # Enables a user in the user pool. After being enabled, users can sign
     # in to WorkSpaces Applications and open applications from the stacks to
     # which they are assigned.
@@ -6050,6 +6082,9 @@ module Aws::AppStream
     #   resp.fleet.compute_capacity_status.available_user_sessions #=> Integer
     #   resp.fleet.compute_capacity_status.active_user_sessions #=> Integer
     #   resp.fleet.compute_capacity_status.actual_user_sessions #=> Integer
+    #   resp.fleet.compute_capacity_status.draining #=> Integer
+    #   resp.fleet.compute_capacity_status.drain_mode_active_user_sessions #=> Integer
+    #   resp.fleet.compute_capacity_status.drain_mode_unused_user_sessions #=> Integer
     #   resp.fleet.max_user_duration_in_seconds #=> Integer
     #   resp.fleet.disconnect_timeout_in_seconds #=> Integer
     #   resp.fleet.state #=> String, one of "STARTING", "RUNNING", "STOPPING", "STOPPED"
@@ -6370,7 +6405,7 @@ module Aws::AppStream
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-appstream'
-      context[:gem_version] = '1.130.0'
+      context[:gem_version] = '1.131.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -200,6 +200,8 @@ module Aws::AppStream
     Domain = Shapes::StringShape.new(name: 'Domain')
     DomainJoinInfo = Shapes::StructureShape.new(name: 'DomainJoinInfo')
     DomainList = Shapes::ListShape.new(name: 'DomainList')
+    DrainSessionInstanceRequest = Shapes::StructureShape.new(name: 'DrainSessionInstanceRequest')
+    DrainSessionInstanceResult = Shapes::StructureShape.new(name: 'DrainSessionInstanceResult')
     DryRunOperationException = Shapes::StructureShape.new(name: 'DryRunOperationException')
     DynamicAppProvidersEnabled = Shapes::StringShape.new(name: 'DynamicAppProvidersEnabled')
     EmbedHostDomain = Shapes::StringShape.new(name: 'EmbedHostDomain')
@@ -256,6 +258,7 @@ module Aws::AppStream
     ImageStateChangeReasonCode = Shapes::StringShape.new(name: 'ImageStateChangeReasonCode')
     ImageType = Shapes::StringShape.new(name: 'ImageType')
     IncompatibleImageException = Shapes::StructureShape.new(name: 'IncompatibleImageException')
+    InstanceDrainStatus = Shapes::StringShape.new(name: 'InstanceDrainStatus')
     InstanceType = Shapes::StringShape.new(name: 'InstanceType')
     Integer = Shapes::IntegerShape.new(name: 'Integer')
     InvalidAccountStatusException = Shapes::StructureShape.new(name: 'InvalidAccountStatusException')
@@ -584,6 +587,9 @@ module Aws::AppStream
     ComputeCapacityStatus.add_member(:available_user_sessions, Shapes::ShapeRef.new(shape: Integer, location_name: "AvailableUserSessions"))
     ComputeCapacityStatus.add_member(:active_user_sessions, Shapes::ShapeRef.new(shape: Integer, location_name: "ActiveUserSessions"))
     ComputeCapacityStatus.add_member(:actual_user_sessions, Shapes::ShapeRef.new(shape: Integer, location_name: "ActualUserSessions"))
+    ComputeCapacityStatus.add_member(:draining, Shapes::ShapeRef.new(shape: Integer, location_name: "Draining"))
+    ComputeCapacityStatus.add_member(:drain_mode_active_user_sessions, Shapes::ShapeRef.new(shape: Integer, location_name: "DrainModeActiveUserSessions"))
+    ComputeCapacityStatus.add_member(:drain_mode_unused_user_sessions, Shapes::ShapeRef.new(shape: Integer, location_name: "DrainModeUnusedUserSessions"))
     ComputeCapacityStatus.struct_class = Types::ComputeCapacityStatus
 
     ConcurrentModificationException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
@@ -1127,6 +1133,11 @@ module Aws::AppStream
 
     DomainList.member = Shapes::ShapeRef.new(shape: Domain)
 
+    DrainSessionInstanceRequest.add_member(:session_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "SessionId"))
+    DrainSessionInstanceRequest.struct_class = Types::DrainSessionInstanceRequest
+
+    DrainSessionInstanceResult.struct_class = Types::DrainSessionInstanceResult
+
     DryRunOperationException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
     DryRunOperationException.struct_class = Types::DryRunOperationException
 
@@ -1436,6 +1447,7 @@ module Aws::AppStream
     Session.add_member(:authentication_type, Shapes::ShapeRef.new(shape: AuthenticationType, location_name: "AuthenticationType"))
     Session.add_member(:network_access_configuration, Shapes::ShapeRef.new(shape: NetworkAccessConfiguration, location_name: "NetworkAccessConfiguration"))
     Session.add_member(:instance_id, Shapes::ShapeRef.new(shape: String, location_name: "InstanceId"))
+    Session.add_member(:instance_drain_status, Shapes::ShapeRef.new(shape: InstanceDrainStatus, location_name: "InstanceDrainStatus"))
     Session.struct_class = Types::Session
 
     SessionList.member = Shapes::ShapeRef.new(shape: Session)
@@ -2528,6 +2540,17 @@ module Aws::AppStream
         o.errors << Shapes::ShapeRef.new(shape: ConcurrentModificationException)
       end)
 
+      api.add_operation(:drain_session_instance, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "DrainSessionInstance"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: DrainSessionInstanceRequest)
+        o.output = Shapes::ShapeRef.new(shape: DrainSessionInstanceResult)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ConcurrentModificationException)
+        o.errors << Shapes::ShapeRef.new(shape: OperationNotPermittedException)
+      end)
+
       api.add_operation(:enable_user, Seahorse::Model::Operation.new.tap do |o|
         o.name = "EnableUser"
         o.http_method = "POST"

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

@@ -851,6 +851,22 @@ module Aws::AppStream
     #   This only applies to multi-session fleets.
     #   @return [Integer]
     #
+    # @!attribute [rw] draining
+    #   The number of instances in drain mode. This only applies to
+    #   multi-session fleets.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] drain_mode_active_user_sessions
+    #   The number of active user sessions on instances in drain mode. This
+    #   only applies to multi-session fleets.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] drain_mode_unused_user_sessions
+    #   The number of unused session slots on instances in drain mode that
+    #   cannot be used for user session provisioning. This only applies to
+    #   multi-session fleets.
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appstream-2016-12-01/ComputeCapacityStatus AWS API Documentation
     #
     class ComputeCapacityStatus < Struct.new(
@@ -861,7 +877,10 @@ module Aws::AppStream
       :desired_user_sessions,
       :available_user_sessions,
       :active_user_sessions,
-      :actual_user_sessions)
+      :actual_user_sessions,
+      :draining,
+      :drain_mode_active_user_sessions,
+      :drain_mode_unused_user_sessions)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3954,6 +3973,22 @@ module Aws::AppStream
       include Aws::Structure
     end
 
+    # @!attribute [rw] session_id
+    #   The identifier of the streaming session.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appstream-2016-12-01/DrainSessionInstanceRequest AWS API Documentation
+    #
+    class DrainSessionInstanceRequest < Struct.new(
+      :session_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/appstream-2016-12-01/DrainSessionInstanceResult AWS API Documentation
+    #
+    class DrainSessionInstanceResult < Aws::EmptyStructure; end
+
     # The exception that is thrown when a dry run operation is requested.
     # This indicates that the validation checks have been performed
     # successfully, but no actual resources were created or modified.
@@ -5629,6 +5664,11 @@ module Aws::AppStream
     #   The identifier for the instance hosting the session.
     #   @return [String]
     #
+    # @!attribute [rw] instance_drain_status
+    #   The drain status of the instance hosting the streaming session. This
+    #   only applies to multi-session fleets.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appstream-2016-12-01/Session AWS API Documentation
     #
     class Session < Struct.new(
@@ -5642,7 +5682,8 @@ module Aws::AppStream
       :max_expiration_time,
       :authentication_type,
       :network_access_configuration,
-      :instance_id)
+      :instance_id,
+      :instance_drain_status)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-appstream.rb

@@ -55,7 +55,7 @@ module Aws::AppStream
   autoload :EndpointProvider, 'aws-sdk-appstream/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-appstream/endpoints'
 
-  GEM_VERSION = '1.130.0'
+  GEM_VERSION = '1.131.0'
 
 end
 

data/sig/client.rbs

@@ -1028,6 +1028,15 @@ module Aws
                                                     ) -> _DisassociateSoftwareFromImageBuilderResponseSuccess
                                                   | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DisassociateSoftwareFromImageBuilderResponseSuccess
 
+      interface _DrainSessionInstanceResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::DrainSessionInstanceResult]
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/AppStream/Client.html#drain_session_instance-instance_method
+      def drain_session_instance: (
+                                    session_id: ::String
+                                  ) -> _DrainSessionInstanceResponseSuccess
+                                | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DrainSessionInstanceResponseSuccess
+
       interface _EnableUserResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::EnableUserResult]
       end

data/sig/types.rbs

@@ -211,6 +211,9 @@ module Aws::AppStream
       attr_accessor available_user_sessions: ::Integer
       attr_accessor active_user_sessions: ::Integer
       attr_accessor actual_user_sessions: ::Integer
+      attr_accessor draining: ::Integer
+      attr_accessor drain_mode_active_user_sessions: ::Integer
+      attr_accessor drain_mode_unused_user_sessions: ::Integer
       SENSITIVE: []
     end
 
@@ -961,6 +964,14 @@ module Aws::AppStream
       SENSITIVE: []
     end
 
+    class DrainSessionInstanceRequest
+      attr_accessor session_id: ::String
+      SENSITIVE: []
+    end
+
+    class DrainSessionInstanceResult < Aws::EmptyStructure
+    end
+
     class DryRunOperationException
       attr_accessor message: ::String
       SENSITIVE: []
@@ -1330,6 +1341,7 @@ module Aws::AppStream
       attr_accessor authentication_type: ("API" | "SAML" | "USERPOOL" | "AWS_AD")
       attr_accessor network_access_configuration: Types::NetworkAccessConfiguration
       attr_accessor instance_id: ::String
+      attr_accessor instance_drain_status: ("ACTIVE" | "DRAINING" | "NOT_APPLICABLE")
       SENSITIVE: []
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-appstream
 version: !ruby/object:Gem::Version
-  version: 1.130.0
+  version: 1.131.0
 platform: ruby
 authors:
 - Amazon Web Services