aws-sdk-gameliftstreams 1.29.0 → 1.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ff60fcffa3f78ff4ac4f7d16a3fc1b3c3c46b46627401cdf845e3b7b50ad3e08
-  data.tar.gz: 26be138f098c2e354dc6f7ec5d25bfab531b33de13626643f768ca20d65ec544
+  metadata.gz: f9c88b87cbc66c4873c0313b6fe9b2c4ff15af38f2affec5ffe346dfe968b15c
+  data.tar.gz: c171bb1feb22263fef55f7aa8cf2183b222b44dfd94621b01f52493e756d17d0
 SHA512:
-  metadata.gz: 523ecf9bc6b794adfab6022cb28f47cc0b0bf5ba8fdb0d01168bd6d950b4b8f4ca17b2bd083fd3feebd797544d85abd3e9ce04c2a0fdbf9df634e6b5f653286a
-  data.tar.gz: 78e7f5e0dc63173f9daab33609d1c1a6f3ae032ec2552a94e75cfcf02967af1f62980364df2366118a090bd46d8626459f59aad1d3d7640512aed6d6cc5738a0
+  metadata.gz: 5d2f356079b86f8aa5ce9380e7d9119b872098c55c3c8a8356ccbe8f67b0c5d5af5bd655a84bef73360b42bc3f87ad09cb2cff4c4a78d9c9b58aae66f41d03ea
+  data.tar.gz: 0ea946eb1762590b164915dcb4672babeb8fc9160b197a510801ead25c87ee52083dfdec1b4c707fdd9adb64a619f91660c14c5ae4b110358caf08f31b5f5a4e

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.30.0 (2026-07-01)
+------------------
+
+* Feature - Added CreateStreamSessionAdminShell API operation to enable customers to establish secure terminal connections to the live runtime environment of streaming sessions for troubleshooting purposes.
+
 1.29.0 (2026-05-22)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.29.0
+1.30.0

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

@@ -635,6 +635,13 @@ module Aws::GameLiftStreams
     # version you want to use. If you change the files at a later time, you
     # will need to create a new Amazon GameLift Streams application.
     #
+    # <note markdown="1"> Creating an application is the only time Amazon GameLift Streams
+    # accesses your Amazon S3 bucket. After the application reaches `READY`
+    # status, you can delete the original files from your Amazon S3 bucket
+    # without affecting the application.
+    #
+    #  </note>
+    #
     # If the request is successful, Amazon GameLift Streams begins to create
     # an application and sets the status to `INITIALIZED`. When an
     # application reaches `READY` status, you can use the application to set
@@ -1237,6 +1244,80 @@ module Aws::GameLiftStreams
       req.send_request(options)
     end
 
+    # Creates an administrative terminal session with full access to the
+    # live runtime environment of the Amazon GameLift Streams stream
+    # session. Use the returned credentials (`SessionId`, `StreamUrl` and
+    # `TokenValue`) with the Amazon Web Services Systems Manager [Session
+    # Manager plugin][1] for the CLI to access the terminal session.
+    #
+    # The stream session must be in one of the following statuses: `ACTIVE`,
+    # `CONNECTED`, `PENDING_CLIENT_RECONNECTION`, or `RECONNECTING`.
+    #
+    # The `StreamUrl` is valid for 60 seconds. After it expires, call this
+    # operation again to get a new URL.
+    #
+    # The returned credentials grant full access to the live runtime
+    # environment of the Amazon GameLift Streams stream session. The
+    # operator who connects to the terminal session has the same level of
+    # access that your Amazon GameLift Streams applications have, including
+    # potentially user input, screen images, and application data files.
+    # Grant permissions to call this operation only to trusted IAM
+    # identities that require live runtime environment access.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html
+    #
+    # @option params [required, String] :identifier
+    #   The stream group that runs this stream session.
+    #
+    #   This value is an [Amazon Resource Name (ARN)][1] or ID that uniquely
+    #   identifies the stream group resource. Example ARN:
+    #   `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4`.
+    #   Example ID: `sg-1AB2C3De4`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html
+    #
+    # @option params [required, String] :stream_session_identifier
+    #   An [Amazon Resource Name (ARN)][1] or ID that uniquely identifies the
+    #   stream session resource. Example ARN:
+    #   `arn:aws:gameliftstreams:us-west-2:111122223333:streamsession/sg-1AB2C3De4/ABC123def4567`.
+    #   Example ID: `ABC123def4567`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html
+    #
+    # @return [Types::CreateStreamSessionAdminShellOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateStreamSessionAdminShellOutput#session_id #session_id} => String
+    #   * {Types::CreateStreamSessionAdminShellOutput#stream_url #stream_url} => String
+    #   * {Types::CreateStreamSessionAdminShellOutput#token_value #token_value} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_stream_session_admin_shell({
+    #     identifier: "Identifier", # required
+    #     stream_session_identifier: "Identifier", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.session_id #=> String
+    #   resp.stream_url #=> String
+    #   resp.token_value #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/gameliftstreams-2018-05-10/CreateStreamSessionAdminShell AWS API Documentation
+    #
+    # @overload create_stream_session_admin_shell(params = {})
+    # @param [Hash] params ({})
+    def create_stream_session_admin_shell(params = {}, options = {})
+      req = build_request(:create_stream_session_admin_shell, params)
+      req.send_request(options)
+    end
+
     # Enables clients to reconnect to a stream session while preserving all
     # session state and data in the disconnected session. This reconnection
     # process can be initiated when a stream session is in either
@@ -2978,7 +3059,7 @@ module Aws::GameLiftStreams
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-gameliftstreams'
-      context[:gem_version] = '1.29.0'
+      context[:gem_version] = '1.30.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -37,6 +37,8 @@ module Aws::GameLiftStreams
     CreateApplicationOutput = Shapes::StructureShape.new(name: 'CreateApplicationOutput')
     CreateStreamGroupInput = Shapes::StructureShape.new(name: 'CreateStreamGroupInput')
     CreateStreamGroupOutput = Shapes::StructureShape.new(name: 'CreateStreamGroupOutput')
+    CreateStreamSessionAdminShellInput = Shapes::StructureShape.new(name: 'CreateStreamSessionAdminShellInput')
+    CreateStreamSessionAdminShellOutput = Shapes::StructureShape.new(name: 'CreateStreamSessionAdminShellOutput')
     CreateStreamSessionConnectionInput = Shapes::StructureShape.new(name: 'CreateStreamSessionConnectionInput')
     CreateStreamSessionConnectionOutput = Shapes::StructureShape.new(name: 'CreateStreamSessionConnectionOutput')
     DefaultApplication = Shapes::StructureShape.new(name: 'DefaultApplication')
@@ -103,6 +105,7 @@ module Aws::GameLiftStreams
     RuntimeEnvironmentType = Shapes::StringShape.new(name: 'RuntimeEnvironmentType')
     RuntimeEnvironmentVersion = Shapes::StringShape.new(name: 'RuntimeEnvironmentVersion')
     ServiceQuotaExceededException = Shapes::StructureShape.new(name: 'ServiceQuotaExceededException')
+    SessionId = Shapes::StringShape.new(name: 'SessionId')
     SessionLengthSeconds = Shapes::IntegerShape.new(name: 'SessionLengthSeconds')
     SignalRequest = Shapes::StringShape.new(name: 'SignalRequest')
     SignalResponse = Shapes::StringShape.new(name: 'SignalResponse')
@@ -114,10 +117,12 @@ module Aws::GameLiftStreams
     StreamGroupStatusReason = Shapes::StringShape.new(name: 'StreamGroupStatusReason')
     StreamGroupSummary = Shapes::StructureShape.new(name: 'StreamGroupSummary')
     StreamGroupSummaryList = Shapes::ListShape.new(name: 'StreamGroupSummaryList')
+    StreamSessionAccessNotReadyException = Shapes::StructureShape.new(name: 'StreamSessionAccessNotReadyException')
     StreamSessionStatus = Shapes::StringShape.new(name: 'StreamSessionStatus')
     StreamSessionStatusReason = Shapes::StringShape.new(name: 'StreamSessionStatusReason')
     StreamSessionSummary = Shapes::StructureShape.new(name: 'StreamSessionSummary')
     StreamSessionSummaryList = Shapes::ListShape.new(name: 'StreamSessionSummaryList')
+    StreamUrl = Shapes::StringShape.new(name: 'StreamUrl')
     String = Shapes::StringShape.new(name: 'String')
     TagKey = Shapes::StringShape.new(name: 'TagKey')
     TagKeyList = Shapes::ListShape.new(name: 'TagKeyList')
@@ -129,6 +134,7 @@ module Aws::GameLiftStreams
     TerminateStreamSessionInput = Shapes::StructureShape.new(name: 'TerminateStreamSessionInput')
     ThrottlingException = Shapes::StructureShape.new(name: 'ThrottlingException')
     Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
+    TokenValue = Shapes::StringShape.new(name: 'TokenValue')
     UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
     UntagResourceResponse = Shapes::StructureShape.new(name: 'UntagResourceResponse')
     UpdateApplicationInput = Shapes::StructureShape.new(name: 'UpdateApplicationInput')
@@ -225,6 +231,15 @@ module Aws::GameLiftStreams
     CreateStreamGroupOutput.add_member(:associated_applications, Shapes::ShapeRef.new(shape: ArnList, location_name: "AssociatedApplications"))
     CreateStreamGroupOutput.struct_class = Types::CreateStreamGroupOutput
 
+    CreateStreamSessionAdminShellInput.add_member(:identifier, Shapes::ShapeRef.new(shape: Identifier, required: true, location: "uri", location_name: "Identifier"))
+    CreateStreamSessionAdminShellInput.add_member(:stream_session_identifier, Shapes::ShapeRef.new(shape: Identifier, required: true, location: "uri", location_name: "StreamSessionIdentifier"))
+    CreateStreamSessionAdminShellInput.struct_class = Types::CreateStreamSessionAdminShellInput
+
+    CreateStreamSessionAdminShellOutput.add_member(:session_id, Shapes::ShapeRef.new(shape: SessionId, location_name: "SessionId"))
+    CreateStreamSessionAdminShellOutput.add_member(:stream_url, Shapes::ShapeRef.new(shape: StreamUrl, location_name: "StreamUrl"))
+    CreateStreamSessionAdminShellOutput.add_member(:token_value, Shapes::ShapeRef.new(shape: TokenValue, location_name: "TokenValue"))
+    CreateStreamSessionAdminShellOutput.struct_class = Types::CreateStreamSessionAdminShellOutput
+
     CreateStreamSessionConnectionInput.add_member(:client_token, Shapes::ShapeRef.new(shape: ClientToken, location_name: "ClientToken", metadata: {"idempotencyToken" => true}))
     CreateStreamSessionConnectionInput.add_member(:identifier, Shapes::ShapeRef.new(shape: Identifier, required: true, location: "uri", location_name: "Identifier"))
     CreateStreamSessionConnectionInput.add_member(:stream_session_identifier, Shapes::ShapeRef.new(shape: Identifier, required: true, location: "uri", location_name: "StreamSessionIdentifier"))
@@ -487,6 +502,9 @@ module Aws::GameLiftStreams
 
     StreamGroupSummaryList.member = Shapes::ShapeRef.new(shape: StreamGroupSummary)
 
+    StreamSessionAccessNotReadyException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Message"))
+    StreamSessionAccessNotReadyException.struct_class = Types::StreamSessionAccessNotReadyException
+
     StreamSessionSummary.add_member(:arn, Shapes::ShapeRef.new(shape: Arn, location_name: "Arn"))
     StreamSessionSummary.add_member(:user_id, Shapes::ShapeRef.new(shape: UserId, location_name: "UserId"))
     StreamSessionSummary.add_member(:status, Shapes::ShapeRef.new(shape: StreamSessionStatus, location_name: "Status"))
@@ -656,6 +674,20 @@ module Aws::GameLiftStreams
         o.errors << Shapes::ShapeRef.new(shape: ServiceQuotaExceededException)
       end)
 
+      api.add_operation(:create_stream_session_admin_shell, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "CreateStreamSessionAdminShell"
+        o.http_method = "POST"
+        o.http_request_uri = "/streamgroups/{Identifier}/streamsessions/{StreamSessionIdentifier}/access"
+        o.input = Shapes::ShapeRef.new(shape: CreateStreamSessionAdminShellInput)
+        o.output = Shapes::ShapeRef.new(shape: CreateStreamSessionAdminShellOutput)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: StreamSessionAccessNotReadyException)
+      end)
+
       api.add_operation(:create_stream_session_connection, Seahorse::Model::Operation.new.tap do |o|
         o.name = "CreateStreamSessionConnection"
         o.http_method = "POST"

data/lib/aws-sdk-gameliftstreams/errors.rb

@@ -32,6 +32,7 @@ module Aws::GameLiftStreams
   # * {InternalServerException}
   # * {ResourceNotFoundException}
   # * {ServiceQuotaExceededException}
+  # * {StreamSessionAccessNotReadyException}
   # * {ThrottlingException}
   # * {ValidationException}
   #
@@ -120,6 +121,25 @@ module Aws::GameLiftStreams
       end
     end
 
+    class StreamSessionAccessNotReadyException < ServiceError
+
+      # @param [Seahorse::Client::RequestContext] context
+      # @param [String] message
+      # @param [Aws::GameLiftStreams::Types::StreamSessionAccessNotReadyException] data
+      def initialize(context, message, data = Aws::EmptyStructure.new)
+        super(context, message, data)
+      end
+
+      # @return [String]
+      def message
+        @message || @data[:message]
+      end
+
+      def retryable?
+        true
+      end
+    end
+
     class ThrottlingException < ServiceError
 
       # @param [Seahorse::Client::RequestContext] context

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

@@ -1203,6 +1203,68 @@ module Aws::GameLiftStreams
       include Aws::Structure
     end
 
+    # @!attribute [rw] identifier
+    #   The stream group that runs this stream session.
+    #
+    #   This value is an [Amazon Resource Name (ARN)][1] or ID that uniquely
+    #   identifies the stream group resource. Example ARN:
+    #   `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4`.
+    #   Example ID: `sg-1AB2C3De4`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html
+    #   @return [String]
+    #
+    # @!attribute [rw] stream_session_identifier
+    #   An [Amazon Resource Name (ARN)][1] or ID that uniquely identifies
+    #   the stream session resource. Example ARN:
+    #   `arn:aws:gameliftstreams:us-west-2:111122223333:streamsession/sg-1AB2C3De4/ABC123def4567`.
+    #   Example ID: `ABC123def4567`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/gameliftstreams-2018-05-10/CreateStreamSessionAdminShellInput AWS API Documentation
+    #
+    class CreateStreamSessionAdminShellInput < Struct.new(
+      :identifier,
+      :stream_session_identifier)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] session_id
+    #   An Amazon Web Services Systems Manager session identifier that
+    #   uniquely identifies the requested terminal session. Use this value
+    #   with the Amazon Web Services Systems Manager Session Manager plugin.
+    #   @return [String]
+    #
+    # @!attribute [rw] stream_url
+    #   An Amazon Web Services Systems Manager WebSocket connection endpoint
+    #   for the requested terminal session.
+    #   @return [String]
+    #
+    # @!attribute [rw] token_value
+    #   An Amazon Web Services Systems Manager authentication token that
+    #   authenticates your access to the session ID and WebSocket URL. This
+    #   token must be treated with the same level of security as other user
+    #   credentials. The token value is only valid for establishing a new
+    #   connection within 60 seconds of generation.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/gameliftstreams-2018-05-10/CreateStreamSessionAdminShellOutput AWS API Documentation
+    #
+    class CreateStreamSessionAdminShellOutput < Struct.new(
+      :session_id,
+      :stream_url,
+      :token_value)
+      SENSITIVE = [:token_value]
+      include Aws::Structure
+    end
+
     # @!attribute [rw] client_token
     #   A unique identifier that represents a client request. The request is
     #   idempotent, which ensures that an API request completes only once.
@@ -3682,6 +3744,21 @@ module Aws::GameLiftStreams
       include Aws::Structure
     end
 
+    # The terminal connection to the stream session is not yet available.
+    # Wait before retrying the request.
+    #
+    # @!attribute [rw] message
+    #   Description of the error.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/gameliftstreams-2018-05-10/StreamSessionAccessNotReadyException AWS API Documentation
+    #
+    class StreamSessionAccessNotReadyException < Struct.new(
+      :message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes an Amazon GameLift Streams stream session. To retrieve
     # additional details for the stream session, call [GetStreamSession][1].
     #

data/lib/aws-sdk-gameliftstreams.rb

@@ -55,7 +55,7 @@ module Aws::GameLiftStreams
   autoload :EndpointProvider, 'aws-sdk-gameliftstreams/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-gameliftstreams/endpoints'
 
-  GEM_VERSION = '1.29.0'
+  GEM_VERSION = '1.30.0'
 
 end
 

data/sig/client.rbs

@@ -165,6 +165,19 @@ module Aws
                                ) -> _CreateStreamGroupResponseSuccess
                              | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateStreamGroupResponseSuccess
 
+      interface _CreateStreamSessionAdminShellResponseSuccess
+        include ::Seahorse::Client::_ResponseSuccess[Types::CreateStreamSessionAdminShellOutput]
+        def session_id: () -> ::String
+        def stream_url: () -> ::String
+        def token_value: () -> ::String
+      end
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/GameLiftStreams/Client.html#create_stream_session_admin_shell-instance_method
+      def create_stream_session_admin_shell: (
+                                               identifier: ::String,
+                                               stream_session_identifier: ::String
+                                             ) -> _CreateStreamSessionAdminShellResponseSuccess
+                                           | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateStreamSessionAdminShellResponseSuccess
+
       interface _CreateStreamSessionConnectionResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::CreateStreamSessionConnectionOutput]
         def signal_response: () -> ::String

data/sig/errors.rbs

@@ -26,6 +26,9 @@ module Aws
       class ServiceQuotaExceededException < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end
+      class StreamSessionAccessNotReadyException < ::Aws::Errors::ServiceError
+        def message: () -> ::String
+      end
       class ThrottlingException < ::Aws::Errors::ServiceError
         def message: () -> ::String
       end

data/sig/types.rbs

@@ -109,6 +109,19 @@ module Aws::GameLiftStreams
       SENSITIVE: []
     end
 
+    class CreateStreamSessionAdminShellInput
+      attr_accessor identifier: ::String
+      attr_accessor stream_session_identifier: ::String
+      SENSITIVE: []
+    end
+
+    class CreateStreamSessionAdminShellOutput
+      attr_accessor session_id: ::String
+      attr_accessor stream_url: ::String
+      attr_accessor token_value: ::String
+      SENSITIVE: [:token_value]
+    end
+
     class CreateStreamSessionConnectionInput
       attr_accessor client_token: ::String
       attr_accessor identifier: ::String
@@ -423,6 +436,11 @@ module Aws::GameLiftStreams
       SENSITIVE: []
     end
 
+    class StreamSessionAccessNotReadyException
+      attr_accessor message: ::String
+      SENSITIVE: []
+    end
+
     class StreamSessionSummary
       attr_accessor arn: ::String
       attr_accessor user_id: ::String

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-gameliftstreams
 version: !ruby/object:Gem::Version
-  version: 1.29.0
+  version: 1.30.0
 platform: ruby
 authors:
 - Amazon Web Services