aws-sdk-appstream 1.130.0 → 1.132.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5103c3fa612becad412d4884ef50383325779713ab4531de89e0c2d2618597d
-  data.tar.gz: 9fe9ffdc7267d8c4dc00476d425d317650658ef954320d6c816a2d32c363fc53
+  metadata.gz: 3e6e0dc1f35986a1bb4fc18a4dce4ab266ba812236a81a6f02cbc932c547c197
+  data.tar.gz: 5f00628125053983cd30a8b9634b57056b4cbc2be67eea9fb4666929589f3731
 SHA512:
-  metadata.gz: ebf0643008138c350c96cfb16c2bcd42f44356765efe7684569ceccf1612dab49c33f503a12a5118c1340dc80016a83f99a24259794f545a33238e33fee0ffa9
-  data.tar.gz: 5091b75268259a0f0dc966ab2688bbb392eaf42328a5932c42bf3f54f853988dce1645e5bc89b6612c945ac8ed31d379e51fe14b9f5cf22fc663dedbd58185e1
+  metadata.gz: fcd2c4ce358648d6cacc2c2381e9ab278b2878b85f292189c7fdb0cf6165fadab4b9351a2719b87142d5e331c68eaad6c1c8eac40101caab72272181d4ffc7b5
+  data.tar.gz: d8b83cfc3634a3d7c182d87d3354b8cd52f69e727947e1cc4de49b9b8eaf00ba4dadc6046b536338928c7ee70f369362a809d589ccddcba698cc050095f776ca

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.132.0 (2026-04-16)
+------------------
+
+* Feature - Add content redirection to Update Stack
+
+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.132.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"
@@ -6173,6 +6208,11 @@ module Aws::AppStream
     #   The streaming protocol you want your stack to prefer. This can be UDP
     #   or TCP. Currently, UDP is only supported in the Windows native client.
     #
+    # @option params [Types::ContentRedirection] :content_redirection
+    #   Configuration for bidirectional URL redirection between the streaming
+    #   session and the local client. Use HostToClient to redirect URLs from
+    #   the remote desktop to the local browser.
+    #
     # @return [Types::UpdateStackResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateStackResult#stack #stack} => Types::Stack
@@ -6216,6 +6256,13 @@ module Aws::AppStream
     #     streaming_experience_settings: {
     #       preferred_protocol: "TCP", # accepts TCP, UDP
     #     },
+    #     content_redirection: {
+    #       host_to_client: {
+    #         enabled: false, # required
+    #         allowed_urls: ["UrlPattern"],
+    #         denied_urls: ["UrlPattern"],
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -6370,7 +6417,7 @@ module Aws::AppStream
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-appstream'
-      context[:gem_version] = '1.130.0'
+      context[:gem_version] = '1.132.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)
@@ -1669,6 +1681,7 @@ module Aws::AppStream
     UpdateStackRequest.add_member(:access_endpoints, Shapes::ShapeRef.new(shape: AccessEndpointList, location_name: "AccessEndpoints"))
     UpdateStackRequest.add_member(:embed_host_domains, Shapes::ShapeRef.new(shape: EmbedHostDomains, location_name: "EmbedHostDomains"))
     UpdateStackRequest.add_member(:streaming_experience_settings, Shapes::ShapeRef.new(shape: StreamingExperienceSettings, location_name: "StreamingExperienceSettings"))
+    UpdateStackRequest.add_member(:content_redirection, Shapes::ShapeRef.new(shape: ContentRedirection, location_name: "ContentRedirection"))
     UpdateStackRequest.struct_class = Types::UpdateStackRequest
 
     UpdateStackResult.add_member(:stack, Shapes::ShapeRef.new(shape: Stack, location_name: "Stack"))
@@ -2528,6 +2541,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
@@ -6873,6 +6914,12 @@ module Aws::AppStream
     #   client.
     #   @return [Types::StreamingExperienceSettings]
     #
+    # @!attribute [rw] content_redirection
+    #   Configuration for bidirectional URL redirection between the
+    #   streaming session and the local client. Use HostToClient to redirect
+    #   URLs from the remote desktop to the local browser.
+    #   @return [Types::ContentRedirection]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/appstream-2016-12-01/UpdateStackRequest AWS API Documentation
     #
     class UpdateStackRequest < Struct.new(
@@ -6888,7 +6935,8 @@ module Aws::AppStream
       :application_settings,
       :access_endpoints,
       :embed_host_domains,
-      :streaming_experience_settings)
+      :streaming_experience_settings,
+      :content_redirection)
       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.132.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
@@ -1401,6 +1410,13 @@ module Aws
                           ?embed_host_domains: Array[::String],
                           ?streaming_experience_settings: {
                             preferred_protocol: ("TCP" | "UDP")?
+                          },
+                          ?content_redirection: {
+                            host_to_client: {
+                              enabled: bool,
+                              allowed_urls: Array[::String]?,
+                              denied_urls: Array[::String]?
+                            }?
                           }
                         ) -> _UpdateStackResponseSuccess
                       | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _UpdateStackResponseSuccess

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
 
@@ -1608,6 +1620,7 @@ module Aws::AppStream
       attr_accessor access_endpoints: ::Array[Types::AccessEndpoint]
       attr_accessor embed_host_domains: ::Array[::String]
       attr_accessor streaming_experience_settings: Types::StreamingExperienceSettings
+      attr_accessor content_redirection: Types::ContentRedirection
       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.132.0
 platform: ruby
 authors:
 - Amazon Web Services