aws-sdk-ivsrealtime 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7dec4a4e38b3a37a42c058509b62b47b231fd95eb06dde8f4caadc5b0871b109
-  data.tar.gz: 43fc5bce670744d8ce8b2693586fd486a3f8aa18d4d35529a6d1e9a4ac1b2d8b
+  metadata.gz: b02fdb8bdabe4457d10d87e3b8e48037e8a63291de686aee50579407aa54f939
+  data.tar.gz: cb7213d02b74146fe4f6131b61df1948a261bcee832e48a033cfd455df10c97b
 SHA512:
-  metadata.gz: 7be2c478eb5c437bd704ecf5e1fd4981ad049d04e2a6d234d72201c7b73f856b35648ae2bef6277fcfa20952c1555a2bb8b8fab642104bd6f76f3a9207f0d4e8
-  data.tar.gz: 107cd403ae0f4535a324d6deae2a954f4368ac7252c797a9c9840e1f7e5e98d38c66d3b4c09a44d1269892e335738ba2f886a2e02821f7223a690658ed31104e
+  metadata.gz: 29fc395a7f74e2be3513b6ea734e9db623a00f9b0d2ba04a5be35e076128735acd75d9770fa05fc1b70eb1ab2f6cd0cd6af40e60f6c01affb9a09393fa1d1236
+  data.tar.gz: c3825a9ff90066d5d02c928874a585450c81fd17619bb406742c92bd470c34fa075fbb7e307f6ed5fdb8fcb85602e1e2d2e49785197693aac101aec8571030df

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.2.0 (2023-05-11)
+------------------
+
+* Feature - Add methods for inspecting and debugging stages: ListStageSessions, GetStageSession, ListParticipants, GetParticipant, and ListParticipantEvents.
+
 1.1.0 (2023-04-05)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.1.0
+1.2.0

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

@@ -387,8 +387,8 @@ module Aws::IVSRealTime
     #   Default: `PUBLISH, SUBSCRIBE`.
     #
     # @option params [Integer] :duration
-    #   Duration (in minutes), after which the token expires. Default: 60 (1
-    #   hour).
+    #   Duration (in minutes), after which the token expires. Default: 720 (12
+    #   hours).
     #
     # @option params [required, String] :stage_arn
     #   ARN of the stage to which this token is scoped.
@@ -534,8 +534,8 @@ module Aws::IVSRealTime
     # permanently from a specified stage.
     #
     # @option params [required, String] :participant_id
-    #   Identifier of the participant to be disconnected. This is returned by
-    #   CreateParticipantToken.
+    #   Identifier of the participant to be disconnected. This is assigned by
+    #   IVS and returned by CreateParticipantToken.
     #
     # @option params [String] :reason
     #   Description of why this participant is being disconnected.
@@ -562,6 +562,49 @@ module Aws::IVSRealTime
       req.send_request(options)
     end
 
+    # Gets information about the specified participant token.
+    #
+    # @option params [required, String] :participant_id
+    #   Unique identifier for the participant. This is assigned by IVS and
+    #   returned by CreateParticipantToken.
+    #
+    # @option params [required, String] :session_id
+    #   ID of a session within the stage.
+    #
+    # @option params [required, String] :stage_arn
+    #   Stage ARN.
+    #
+    # @return [Types::GetParticipantResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetParticipantResponse#participant #participant} => Types::Participant
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_participant({
+    #     participant_id: "ParticipantId", # required
+    #     session_id: "StageSessionId", # required
+    #     stage_arn: "StageArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.participant.attributes #=> Hash
+    #   resp.participant.attributes["String"] #=> String
+    #   resp.participant.first_join_time #=> Time
+    #   resp.participant.participant_id #=> String
+    #   resp.participant.published #=> Boolean
+    #   resp.participant.state #=> String, one of "CONNECTED", "DISCONNECTED"
+    #   resp.participant.user_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/GetParticipant AWS API Documentation
+    #
+    # @overload get_participant(params = {})
+    # @param [Hash] params ({})
+    def get_participant(params = {}, options = {})
+      req = build_request(:get_participant, params)
+      req.send_request(options)
+    end
+
     # Gets information for the specified stage.
     #
     # @option params [required, String] :arn
@@ -594,6 +637,210 @@ module Aws::IVSRealTime
       req.send_request(options)
     end
 
+    # Gets information for the specified stage session.
+    #
+    # @option params [required, String] :session_id
+    #   ID of a session within the stage.
+    #
+    # @option params [required, String] :stage_arn
+    #   ARN of the stage for which the information is to be retrieved.
+    #
+    # @return [Types::GetStageSessionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetStageSessionResponse#stage_session #stage_session} => Types::StageSession
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_stage_session({
+    #     session_id: "StageSessionId", # required
+    #     stage_arn: "StageArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.stage_session.end_time #=> Time
+    #   resp.stage_session.session_id #=> String
+    #   resp.stage_session.start_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/GetStageSession AWS API Documentation
+    #
+    # @overload get_stage_session(params = {})
+    # @param [Hash] params ({})
+    def get_stage_session(params = {}, options = {})
+      req = build_request(:get_stage_session, params)
+      req.send_request(options)
+    end
+
+    # Lists events for a specified participant that occurred during a
+    # specified stage session.
+    #
+    # @option params [Integer] :max_results
+    #   Maximum number of results to return. Default: 50.
+    #
+    # @option params [String] :next_token
+    #   The first participant to retrieve. This is used for pagination; see
+    #   the `nextToken` response field.
+    #
+    # @option params [required, String] :participant_id
+    #   Unique identifier for this participant. This is assigned by IVS and
+    #   returned by CreateParticipantToken.
+    #
+    # @option params [required, String] :session_id
+    #   ID of a session within the stage.
+    #
+    # @option params [required, String] :stage_arn
+    #   Stage ARN.
+    #
+    # @return [Types::ListParticipantEventsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListParticipantEventsResponse#events #events} => Array<Types::Event>
+    #   * {Types::ListParticipantEventsResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_participant_events({
+    #     max_results: 1,
+    #     next_token: "PaginationToken",
+    #     participant_id: "ParticipantId", # required
+    #     session_id: "StageSessionId", # required
+    #     stage_arn: "StageArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.events #=> Array
+    #   resp.events[0].error_code #=> String, one of "INSUFFICIENT_CAPABILITIES"
+    #   resp.events[0].event_time #=> Time
+    #   resp.events[0].name #=> String, one of "JOINED", "LEFT", "PUBLISH_STARTED", "PUBLISH_STOPPED", "SUBSCRIBE_STARTED", "SUBSCRIBE_STOPPED", "PUBLISH_ERROR", "SUBSCRIBE_ERROR", "JOIN_ERROR"
+    #   resp.events[0].participant_id #=> String
+    #   resp.events[0].remote_participant_id #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ListParticipantEvents AWS API Documentation
+    #
+    # @overload list_participant_events(params = {})
+    # @param [Hash] params ({})
+    def list_participant_events(params = {}, options = {})
+      req = build_request(:list_participant_events, params)
+      req.send_request(options)
+    end
+
+    # Lists all participants in a specified stage session.
+    #
+    # @option params [Boolean] :filter_by_published
+    #   Filters the response list to only show participants who published
+    #   during the stage session. Only one of `filterByUserId`,
+    #   `filterByPublished`, or `filterByState` can be provided per request.
+    #
+    # @option params [String] :filter_by_state
+    #   Filters the response list to only show participants in the specified
+    #   state. Only one of `filterByUserId`, `filterByPublished`, or
+    #   `filterByState` can be provided per request.
+    #
+    # @option params [String] :filter_by_user_id
+    #   Filters the response list to match the specified user ID. Only one of
+    #   `filterByUserId`, `filterByPublished`, or `filterByState` can be
+    #   provided per request. A `userId` is a customer-assigned name to help
+    #   identify the token; this can be used to link a participant to a user
+    #   in the customer’s own systems.
+    #
+    # @option params [Integer] :max_results
+    #   Maximum number of results to return. Default: 50.
+    #
+    # @option params [String] :next_token
+    #   The first participant to retrieve. This is used for pagination; see
+    #   the `nextToken` response field.
+    #
+    # @option params [required, String] :session_id
+    #   ID of the session within the stage.
+    #
+    # @option params [required, String] :stage_arn
+    #   Stage ARN.
+    #
+    # @return [Types::ListParticipantsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListParticipantsResponse#next_token #next_token} => String
+    #   * {Types::ListParticipantsResponse#participants #participants} => Array<Types::ParticipantSummary>
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_participants({
+    #     filter_by_published: false,
+    #     filter_by_state: "CONNECTED", # accepts CONNECTED, DISCONNECTED
+    #     filter_by_user_id: "UserId",
+    #     max_results: 1,
+    #     next_token: "PaginationToken",
+    #     session_id: "StageSessionId", # required
+    #     stage_arn: "StageArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.next_token #=> String
+    #   resp.participants #=> Array
+    #   resp.participants[0].first_join_time #=> Time
+    #   resp.participants[0].participant_id #=> String
+    #   resp.participants[0].published #=> Boolean
+    #   resp.participants[0].state #=> String, one of "CONNECTED", "DISCONNECTED"
+    #   resp.participants[0].user_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ListParticipants AWS API Documentation
+    #
+    # @overload list_participants(params = {})
+    # @param [Hash] params ({})
+    def list_participants(params = {}, options = {})
+      req = build_request(:list_participants, params)
+      req.send_request(options)
+    end
+
+    # Gets all sessions for a specified stage.
+    #
+    # @option params [Integer] :max_results
+    #   Maximum number of results to return. Default: 50.
+    #
+    # @option params [String] :next_token
+    #   The first stage to retrieve. This is used for pagination; see the
+    #   `nextToken` response field.
+    #
+    # @option params [required, String] :stage_arn
+    #   Stage ARN.
+    #
+    # @return [Types::ListStageSessionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListStageSessionsResponse#next_token #next_token} => String
+    #   * {Types::ListStageSessionsResponse#stage_sessions #stage_sessions} => Array<Types::StageSessionSummary>
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_stage_sessions({
+    #     max_results: 1,
+    #     next_token: "PaginationToken",
+    #     stage_arn: "StageArn", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.next_token #=> String
+    #   resp.stage_sessions #=> Array
+    #   resp.stage_sessions[0].end_time #=> Time
+    #   resp.stage_sessions[0].session_id #=> String
+    #   resp.stage_sessions[0].start_time #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ListStageSessions AWS API Documentation
+    #
+    # @overload list_stage_sessions(params = {})
+    # @param [Hash] params ({})
+    def list_stage_sessions(params = {}, options = {})
+      req = build_request(:list_stage_sessions, params)
+      req.send_request(options)
+    end
+
     # Gets summary information about all stages in your account, in the AWS
     # region where the API request is processed.
     #
@@ -785,7 +1032,7 @@ module Aws::IVSRealTime
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-ivsrealtime'
-      context[:gem_version] = '1.1.0'
+      context[:gem_version] = '1.2.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -24,15 +24,38 @@ module Aws::IVSRealTime
     DisconnectParticipantReason = Shapes::StringShape.new(name: 'DisconnectParticipantReason')
     DisconnectParticipantRequest = Shapes::StructureShape.new(name: 'DisconnectParticipantRequest')
     DisconnectParticipantResponse = Shapes::StructureShape.new(name: 'DisconnectParticipantResponse')
+    Event = Shapes::StructureShape.new(name: 'Event')
+    EventErrorCode = Shapes::StringShape.new(name: 'EventErrorCode')
+    EventList = Shapes::ListShape.new(name: 'EventList')
+    EventName = Shapes::StringShape.new(name: 'EventName')
+    GetParticipantRequest = Shapes::StructureShape.new(name: 'GetParticipantRequest')
+    GetParticipantResponse = Shapes::StructureShape.new(name: 'GetParticipantResponse')
     GetStageRequest = Shapes::StructureShape.new(name: 'GetStageRequest')
     GetStageResponse = Shapes::StructureShape.new(name: 'GetStageResponse')
+    GetStageSessionRequest = Shapes::StructureShape.new(name: 'GetStageSessionRequest')
+    GetStageSessionResponse = Shapes::StructureShape.new(name: 'GetStageSessionResponse')
     InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
+    ListParticipantEventsRequest = Shapes::StructureShape.new(name: 'ListParticipantEventsRequest')
+    ListParticipantEventsResponse = Shapes::StructureShape.new(name: 'ListParticipantEventsResponse')
+    ListParticipantsRequest = Shapes::StructureShape.new(name: 'ListParticipantsRequest')
+    ListParticipantsResponse = Shapes::StructureShape.new(name: 'ListParticipantsResponse')
+    ListStageSessionsRequest = Shapes::StructureShape.new(name: 'ListStageSessionsRequest')
+    ListStageSessionsResponse = Shapes::StructureShape.new(name: 'ListStageSessionsResponse')
     ListStagesRequest = Shapes::StructureShape.new(name: 'ListStagesRequest')
     ListStagesResponse = Shapes::StructureShape.new(name: 'ListStagesResponse')
     ListTagsForResourceRequest = Shapes::StructureShape.new(name: 'ListTagsForResourceRequest')
     ListTagsForResourceResponse = Shapes::StructureShape.new(name: 'ListTagsForResourceResponse')
+    MaxParticipantEventResults = Shapes::IntegerShape.new(name: 'MaxParticipantEventResults')
+    MaxParticipantResults = Shapes::IntegerShape.new(name: 'MaxParticipantResults')
     MaxStageResults = Shapes::IntegerShape.new(name: 'MaxStageResults')
+    MaxStageSessionResults = Shapes::IntegerShape.new(name: 'MaxStageSessionResults')
     PaginationToken = Shapes::StringShape.new(name: 'PaginationToken')
+    Participant = Shapes::StructureShape.new(name: 'Participant')
+    ParticipantAttributes = Shapes::MapShape.new(name: 'ParticipantAttributes')
+    ParticipantId = Shapes::StringShape.new(name: 'ParticipantId')
+    ParticipantList = Shapes::ListShape.new(name: 'ParticipantList')
+    ParticipantState = Shapes::StringShape.new(name: 'ParticipantState')
+    ParticipantSummary = Shapes::StructureShape.new(name: 'ParticipantSummary')
     ParticipantToken = Shapes::StructureShape.new(name: 'ParticipantToken')
     ParticipantTokenAttributes = Shapes::MapShape.new(name: 'ParticipantTokenAttributes')
     ParticipantTokenCapabilities = Shapes::ListShape.new(name: 'ParticipantTokenCapabilities')
@@ -46,13 +69,17 @@ module Aws::IVSRealTime
     ParticipantTokenString = Shapes::StringShape.new(name: 'ParticipantTokenString')
     ParticipantTokenUserId = Shapes::StringShape.new(name: 'ParticipantTokenUserId')
     PendingVerification = Shapes::StructureShape.new(name: 'PendingVerification')
+    Published = Shapes::BooleanShape.new(name: 'Published')
     ResourceArn = Shapes::StringShape.new(name: 'ResourceArn')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     ServiceQuotaExceededException = Shapes::StructureShape.new(name: 'ServiceQuotaExceededException')
     Stage = Shapes::StructureShape.new(name: 'Stage')
     StageArn = Shapes::StringShape.new(name: 'StageArn')
     StageName = Shapes::StringShape.new(name: 'StageName')
+    StageSession = Shapes::StructureShape.new(name: 'StageSession')
     StageSessionId = Shapes::StringShape.new(name: 'StageSessionId')
+    StageSessionList = Shapes::ListShape.new(name: 'StageSessionList')
+    StageSessionSummary = Shapes::StructureShape.new(name: 'StageSessionSummary')
     StageSummary = Shapes::StructureShape.new(name: 'StageSummary')
     StageSummaryList = Shapes::ListShape.new(name: 'StageSummaryList')
     String = Shapes::StringShape.new(name: 'String')
@@ -62,10 +89,12 @@ module Aws::IVSRealTime
     TagResourceResponse = Shapes::StructureShape.new(name: 'TagResourceResponse')
     TagValue = Shapes::StringShape.new(name: 'TagValue')
     Tags = Shapes::MapShape.new(name: 'Tags')
+    Time = Shapes::TimestampShape.new(name: 'Time', timestampFormat: "iso8601")
     UntagResourceRequest = Shapes::StructureShape.new(name: 'UntagResourceRequest')
     UntagResourceResponse = Shapes::StructureShape.new(name: 'UntagResourceResponse')
     UpdateStageRequest = Shapes::StructureShape.new(name: 'UpdateStageRequest')
     UpdateStageResponse = Shapes::StructureShape.new(name: 'UpdateStageResponse')
+    UserId = Shapes::StringShape.new(name: 'UserId')
     ValidationException = Shapes::StructureShape.new(name: 'ValidationException')
     errorMessage = Shapes::StringShape.new(name: 'errorMessage')
 
@@ -106,15 +135,72 @@ module Aws::IVSRealTime
 
     DisconnectParticipantResponse.struct_class = Types::DisconnectParticipantResponse
 
+    Event.add_member(:error_code, Shapes::ShapeRef.new(shape: EventErrorCode, location_name: "errorCode"))
+    Event.add_member(:event_time, Shapes::ShapeRef.new(shape: Time, location_name: "eventTime"))
+    Event.add_member(:name, Shapes::ShapeRef.new(shape: EventName, location_name: "name"))
+    Event.add_member(:participant_id, Shapes::ShapeRef.new(shape: ParticipantId, location_name: "participantId"))
+    Event.add_member(:remote_participant_id, Shapes::ShapeRef.new(shape: ParticipantId, location_name: "remoteParticipantId"))
+    Event.struct_class = Types::Event
+
+    EventList.member = Shapes::ShapeRef.new(shape: Event)
+
+    GetParticipantRequest.add_member(:participant_id, Shapes::ShapeRef.new(shape: ParticipantId, required: true, location_name: "participantId"))
+    GetParticipantRequest.add_member(:session_id, Shapes::ShapeRef.new(shape: StageSessionId, required: true, location_name: "sessionId"))
+    GetParticipantRequest.add_member(:stage_arn, Shapes::ShapeRef.new(shape: StageArn, required: true, location_name: "stageArn"))
+    GetParticipantRequest.struct_class = Types::GetParticipantRequest
+
+    GetParticipantResponse.add_member(:participant, Shapes::ShapeRef.new(shape: Participant, location_name: "participant"))
+    GetParticipantResponse.struct_class = Types::GetParticipantResponse
+
     GetStageRequest.add_member(:arn, Shapes::ShapeRef.new(shape: StageArn, required: true, location_name: "arn"))
     GetStageRequest.struct_class = Types::GetStageRequest
 
     GetStageResponse.add_member(:stage, Shapes::ShapeRef.new(shape: Stage, location_name: "stage"))
     GetStageResponse.struct_class = Types::GetStageResponse
 
+    GetStageSessionRequest.add_member(:session_id, Shapes::ShapeRef.new(shape: StageSessionId, required: true, location_name: "sessionId"))
+    GetStageSessionRequest.add_member(:stage_arn, Shapes::ShapeRef.new(shape: StageArn, required: true, location_name: "stageArn"))
+    GetStageSessionRequest.struct_class = Types::GetStageSessionRequest
+
+    GetStageSessionResponse.add_member(:stage_session, Shapes::ShapeRef.new(shape: StageSession, location_name: "stageSession"))
+    GetStageSessionResponse.struct_class = Types::GetStageSessionResponse
+
     InternalServerException.add_member(:exception_message, Shapes::ShapeRef.new(shape: errorMessage, location_name: "exceptionMessage"))
     InternalServerException.struct_class = Types::InternalServerException
 
+    ListParticipantEventsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxParticipantEventResults, location_name: "maxResults"))
+    ListParticipantEventsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "nextToken"))
+    ListParticipantEventsRequest.add_member(:participant_id, Shapes::ShapeRef.new(shape: ParticipantId, required: true, location_name: "participantId"))
+    ListParticipantEventsRequest.add_member(:session_id, Shapes::ShapeRef.new(shape: StageSessionId, required: true, location_name: "sessionId"))
+    ListParticipantEventsRequest.add_member(:stage_arn, Shapes::ShapeRef.new(shape: StageArn, required: true, location_name: "stageArn"))
+    ListParticipantEventsRequest.struct_class = Types::ListParticipantEventsRequest
+
+    ListParticipantEventsResponse.add_member(:events, Shapes::ShapeRef.new(shape: EventList, required: true, location_name: "events"))
+    ListParticipantEventsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "nextToken"))
+    ListParticipantEventsResponse.struct_class = Types::ListParticipantEventsResponse
+
+    ListParticipantsRequest.add_member(:filter_by_published, Shapes::ShapeRef.new(shape: Published, location_name: "filterByPublished"))
+    ListParticipantsRequest.add_member(:filter_by_state, Shapes::ShapeRef.new(shape: ParticipantState, location_name: "filterByState"))
+    ListParticipantsRequest.add_member(:filter_by_user_id, Shapes::ShapeRef.new(shape: UserId, location_name: "filterByUserId"))
+    ListParticipantsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxParticipantResults, location_name: "maxResults"))
+    ListParticipantsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "nextToken"))
+    ListParticipantsRequest.add_member(:session_id, Shapes::ShapeRef.new(shape: StageSessionId, required: true, location_name: "sessionId"))
+    ListParticipantsRequest.add_member(:stage_arn, Shapes::ShapeRef.new(shape: StageArn, required: true, location_name: "stageArn"))
+    ListParticipantsRequest.struct_class = Types::ListParticipantsRequest
+
+    ListParticipantsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "nextToken"))
+    ListParticipantsResponse.add_member(:participants, Shapes::ShapeRef.new(shape: ParticipantList, required: true, location_name: "participants"))
+    ListParticipantsResponse.struct_class = Types::ListParticipantsResponse
+
+    ListStageSessionsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxStageSessionResults, location_name: "maxResults"))
+    ListStageSessionsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "nextToken"))
+    ListStageSessionsRequest.add_member(:stage_arn, Shapes::ShapeRef.new(shape: StageArn, required: true, location_name: "stageArn"))
+    ListStageSessionsRequest.struct_class = Types::ListStageSessionsRequest
+
+    ListStageSessionsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "nextToken"))
+    ListStageSessionsResponse.add_member(:stage_sessions, Shapes::ShapeRef.new(shape: StageSessionList, required: true, location_name: "stageSessions"))
+    ListStageSessionsResponse.struct_class = Types::ListStageSessionsResponse
+
     ListStagesRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxStageResults, location_name: "maxResults"))
     ListStagesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "nextToken"))
     ListStagesRequest.struct_class = Types::ListStagesRequest
@@ -129,6 +215,26 @@ module Aws::IVSRealTime
     ListTagsForResourceResponse.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, required: true, location_name: "tags"))
     ListTagsForResourceResponse.struct_class = Types::ListTagsForResourceResponse
 
+    Participant.add_member(:attributes, Shapes::ShapeRef.new(shape: ParticipantAttributes, location_name: "attributes"))
+    Participant.add_member(:first_join_time, Shapes::ShapeRef.new(shape: Time, location_name: "firstJoinTime"))
+    Participant.add_member(:participant_id, Shapes::ShapeRef.new(shape: ParticipantId, location_name: "participantId"))
+    Participant.add_member(:published, Shapes::ShapeRef.new(shape: Published, location_name: "published"))
+    Participant.add_member(:state, Shapes::ShapeRef.new(shape: ParticipantState, location_name: "state"))
+    Participant.add_member(:user_id, Shapes::ShapeRef.new(shape: UserId, location_name: "userId"))
+    Participant.struct_class = Types::Participant
+
+    ParticipantAttributes.key = Shapes::ShapeRef.new(shape: String)
+    ParticipantAttributes.value = Shapes::ShapeRef.new(shape: String)
+
+    ParticipantList.member = Shapes::ShapeRef.new(shape: ParticipantSummary)
+
+    ParticipantSummary.add_member(:first_join_time, Shapes::ShapeRef.new(shape: Time, location_name: "firstJoinTime"))
+    ParticipantSummary.add_member(:participant_id, Shapes::ShapeRef.new(shape: ParticipantId, location_name: "participantId"))
+    ParticipantSummary.add_member(:published, Shapes::ShapeRef.new(shape: Published, location_name: "published"))
+    ParticipantSummary.add_member(:state, Shapes::ShapeRef.new(shape: ParticipantState, location_name: "state"))
+    ParticipantSummary.add_member(:user_id, Shapes::ShapeRef.new(shape: UserId, location_name: "userId"))
+    ParticipantSummary.struct_class = Types::ParticipantSummary
+
     ParticipantToken.add_member(:attributes, Shapes::ShapeRef.new(shape: ParticipantTokenAttributes, location_name: "attributes"))
     ParticipantToken.add_member(:capabilities, Shapes::ShapeRef.new(shape: ParticipantTokenCapabilities, location_name: "capabilities"))
     ParticipantToken.add_member(:duration, Shapes::ShapeRef.new(shape: ParticipantTokenDurationMinutes, location_name: "duration"))
@@ -168,6 +274,18 @@ module Aws::IVSRealTime
     Stage.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
     Stage.struct_class = Types::Stage
 
+    StageSession.add_member(:end_time, Shapes::ShapeRef.new(shape: Time, location_name: "endTime"))
+    StageSession.add_member(:session_id, Shapes::ShapeRef.new(shape: StageSessionId, location_name: "sessionId"))
+    StageSession.add_member(:start_time, Shapes::ShapeRef.new(shape: Time, location_name: "startTime"))
+    StageSession.struct_class = Types::StageSession
+
+    StageSessionList.member = Shapes::ShapeRef.new(shape: StageSessionSummary)
+
+    StageSessionSummary.add_member(:end_time, Shapes::ShapeRef.new(shape: Time, location_name: "endTime"))
+    StageSessionSummary.add_member(:session_id, Shapes::ShapeRef.new(shape: StageSessionId, location_name: "sessionId"))
+    StageSessionSummary.add_member(:start_time, Shapes::ShapeRef.new(shape: Time, location_name: "startTime"))
+    StageSessionSummary.struct_class = Types::StageSessionSummary
+
     StageSummary.add_member(:active_session_id, Shapes::ShapeRef.new(shape: StageSessionId, location_name: "activeSessionId"))
     StageSummary.add_member(:arn, Shapes::ShapeRef.new(shape: StageArn, required: true, location_name: "arn"))
     StageSummary.add_member(:name, Shapes::ShapeRef.new(shape: StageName, location_name: "name"))
@@ -272,6 +390,17 @@ module Aws::IVSRealTime
         o.errors << Shapes::ShapeRef.new(shape: PendingVerification)
       end)
 
+      api.add_operation(:get_participant, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetParticipant"
+        o.http_method = "POST"
+        o.http_request_uri = "/GetParticipant"
+        o.input = Shapes::ShapeRef.new(shape: GetParticipantRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetParticipantResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+      end)
+
       api.add_operation(:get_stage, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetStage"
         o.http_method = "POST"
@@ -283,6 +412,65 @@ module Aws::IVSRealTime
         o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
       end)
 
+      api.add_operation(:get_stage_session, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetStageSession"
+        o.http_method = "POST"
+        o.http_request_uri = "/GetStageSession"
+        o.input = Shapes::ShapeRef.new(shape: GetStageSessionRequest)
+        o.output = Shapes::ShapeRef.new(shape: GetStageSessionResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+      end)
+
+      api.add_operation(:list_participant_events, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListParticipantEvents"
+        o.http_method = "POST"
+        o.http_request_uri = "/ListParticipantEvents"
+        o.input = Shapes::ShapeRef.new(shape: ListParticipantEventsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListParticipantEventsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
+      api.add_operation(:list_participants, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListParticipants"
+        o.http_method = "POST"
+        o.http_request_uri = "/ListParticipants"
+        o.input = Shapes::ShapeRef.new(shape: ListParticipantsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListParticipantsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
+      api.add_operation(:list_stage_sessions, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListStageSessions"
+        o.http_method = "POST"
+        o.http_request_uri = "/ListStageSessions"
+        o.input = Shapes::ShapeRef.new(shape: ListStageSessionsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListStageSessionsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_stages, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListStages"
         o.http_method = "POST"

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

@@ -67,6 +67,20 @@ module Aws::IVSRealTime
       end
     end
 
+    class GetParticipant
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::IVSRealTime::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 GetStage
       def self.build(context)
         unless context.config.regional_endpoint
@@ -81,6 +95,62 @@ module Aws::IVSRealTime
       end
     end
 
+    class GetStageSession
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::IVSRealTime::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 ListParticipantEvents
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::IVSRealTime::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 ListParticipants
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::IVSRealTime::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 ListStageSessions
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::IVSRealTime::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 ListStages
       def self.build(context)
         unless context.config.regional_endpoint

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

@@ -64,8 +64,18 @@ module Aws::IVSRealTime
             Aws::IVSRealTime::Endpoints::DeleteStage.build(context)
           when :disconnect_participant
             Aws::IVSRealTime::Endpoints::DisconnectParticipant.build(context)
+          when :get_participant
+            Aws::IVSRealTime::Endpoints::GetParticipant.build(context)
           when :get_stage
             Aws::IVSRealTime::Endpoints::GetStage.build(context)
+          when :get_stage_session
+            Aws::IVSRealTime::Endpoints::GetStageSession.build(context)
+          when :list_participant_events
+            Aws::IVSRealTime::Endpoints::ListParticipantEvents.build(context)
+          when :list_participants
+            Aws::IVSRealTime::Endpoints::ListParticipants.build(context)
+          when :list_stage_sessions
+            Aws::IVSRealTime::Endpoints::ListStageSessions.build(context)
           when :list_stages
             Aws::IVSRealTime::Endpoints::ListStages.build(context)
           when :list_tags_for_resource

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

@@ -48,8 +48,8 @@ module Aws::IVSRealTime
     #   @return [Array<String>]
     #
     # @!attribute [rw] duration
-    #   Duration (in minutes), after which the token expires. Default: 60 (1
-    #   hour).
+    #   Duration (in minutes), after which the token expires. Default: 720
+    #   (12 hours).
     #   @return [Integer]
     #
     # @!attribute [rw] stage_arn
@@ -153,8 +153,8 @@ module Aws::IVSRealTime
     class DeleteStageResponse < Aws::EmptyStructure; end
 
     # @!attribute [rw] participant_id
-    #   Identifier of the participant to be disconnected. This is returned
-    #   by CreateParticipantToken.
+    #   Identifier of the participant to be disconnected. This is assigned
+    #   by IVS and returned by CreateParticipantToken.
     #   @return [String]
     #
     # @!attribute [rw] reason
@@ -179,6 +179,85 @@ module Aws::IVSRealTime
     #
     class DisconnectParticipantResponse < Aws::EmptyStructure; end
 
+    # An occurrence during a stage session.
+    #
+    # @!attribute [rw] error_code
+    #   If the event is an error event, the error code is provided to give
+    #   insight into the specific error that occurred. If the event is not
+    #   an error event, this field is null. `INSUFFICIENT_CAPABILITIES`
+    #   indicates that the participant tried to take an action that the
+    #   participant’s token is not allowed to do. For more information about
+    #   participant capabilities, see the `capabilities` field in
+    #   CreateParticipantToken.
+    #   @return [String]
+    #
+    # @!attribute [rw] event_time
+    #   ISO 8601 timestamp (returned as a string) for when the event
+    #   occurred.
+    #   @return [Time]
+    #
+    # @!attribute [rw] name
+    #   The name of the event.
+    #   @return [String]
+    #
+    # @!attribute [rw] participant_id
+    #   Unique identifier for the participant who triggered the event. This
+    #   is assigned by IVS.
+    #   @return [String]
+    #
+    # @!attribute [rw] remote_participant_id
+    #   Unique identifier for the remote participant. For a subscribe event,
+    #   this is the publisher. For a publish or join event, this is null.
+    #   This is assigned by IVS.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/Event AWS API Documentation
+    #
+    class Event < Struct.new(
+      :error_code,
+      :event_time,
+      :name,
+      :participant_id,
+      :remote_participant_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] participant_id
+    #   Unique identifier for the participant. This is assigned by IVS and
+    #   returned by CreateParticipantToken.
+    #   @return [String]
+    #
+    # @!attribute [rw] session_id
+    #   ID of a session within the stage.
+    #   @return [String]
+    #
+    # @!attribute [rw] stage_arn
+    #   Stage ARN.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/GetParticipantRequest AWS API Documentation
+    #
+    class GetParticipantRequest < Struct.new(
+      :participant_id,
+      :session_id,
+      :stage_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] participant
+    #   The participant that is returned.
+    #   @return [Types::Participant]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/GetParticipantResponse AWS API Documentation
+    #
+    class GetParticipantResponse < Struct.new(
+      :participant)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] arn
     #   ARN of the stage for which the information is to be retrieved.
     #   @return [String]
@@ -192,6 +271,7 @@ module Aws::IVSRealTime
     end
 
     # @!attribute [rw] stage
+    #   The stage that is returned.
     #   @return [Types::Stage]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/GetStageResponse AWS API Documentation
@@ -202,6 +282,35 @@ module Aws::IVSRealTime
       include Aws::Structure
     end
 
+    # @!attribute [rw] session_id
+    #   ID of a session within the stage.
+    #   @return [String]
+    #
+    # @!attribute [rw] stage_arn
+    #   ARN of the stage for which the information is to be retrieved.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/GetStageSessionRequest AWS API Documentation
+    #
+    class GetStageSessionRequest < Struct.new(
+      :session_id,
+      :stage_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] stage_session
+    #   The stage session that is returned.
+    #   @return [Types::StageSession]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/GetStageSessionResponse AWS API Documentation
+    #
+    class GetStageSessionResponse < Struct.new(
+      :stage_session)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] exception_message
     #   Unexpected error during processing of request.
     #   @return [String]
@@ -214,6 +323,168 @@ module Aws::IVSRealTime
       include Aws::Structure
     end
 
+    # @!attribute [rw] max_results
+    #   Maximum number of results to return. Default: 50.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   The first participant to retrieve. This is used for pagination; see
+    #   the `nextToken` response field.
+    #   @return [String]
+    #
+    # @!attribute [rw] participant_id
+    #   Unique identifier for this participant. This is assigned by IVS and
+    #   returned by CreateParticipantToken.
+    #   @return [String]
+    #
+    # @!attribute [rw] session_id
+    #   ID of a session within the stage.
+    #   @return [String]
+    #
+    # @!attribute [rw] stage_arn
+    #   Stage ARN.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ListParticipantEventsRequest AWS API Documentation
+    #
+    class ListParticipantEventsRequest < Struct.new(
+      :max_results,
+      :next_token,
+      :participant_id,
+      :session_id,
+      :stage_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] events
+    #   List of the matching events.
+    #   @return [Array<Types::Event>]
+    #
+    # @!attribute [rw] next_token
+    #   If there are more rooms than `maxResults`, use `nextToken` in the
+    #   request to get the next set.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ListParticipantEventsResponse AWS API Documentation
+    #
+    class ListParticipantEventsResponse < Struct.new(
+      :events,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] filter_by_published
+    #   Filters the response list to only show participants who published
+    #   during the stage session. Only one of `filterByUserId`,
+    #   `filterByPublished`, or `filterByState` can be provided per request.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] filter_by_state
+    #   Filters the response list to only show participants in the specified
+    #   state. Only one of `filterByUserId`, `filterByPublished`, or
+    #   `filterByState` can be provided per request.
+    #   @return [String]
+    #
+    # @!attribute [rw] filter_by_user_id
+    #   Filters the response list to match the specified user ID. Only one
+    #   of `filterByUserId`, `filterByPublished`, or `filterByState` can be
+    #   provided per request. A `userId` is a customer-assigned name to help
+    #   identify the token; this can be used to link a participant to a user
+    #   in the customer’s own systems.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   Maximum number of results to return. Default: 50.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   The first participant to retrieve. This is used for pagination; see
+    #   the `nextToken` response field.
+    #   @return [String]
+    #
+    # @!attribute [rw] session_id
+    #   ID of the session within the stage.
+    #   @return [String]
+    #
+    # @!attribute [rw] stage_arn
+    #   Stage ARN.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ListParticipantsRequest AWS API Documentation
+    #
+    class ListParticipantsRequest < Struct.new(
+      :filter_by_published,
+      :filter_by_state,
+      :filter_by_user_id,
+      :max_results,
+      :next_token,
+      :session_id,
+      :stage_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] next_token
+    #   If there are more rooms than `maxResults`, use `nextToken` in the
+    #   request to get the next set.
+    #   @return [String]
+    #
+    # @!attribute [rw] participants
+    #   List of the matching participants (summary information only).
+    #   @return [Array<Types::ParticipantSummary>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ListParticipantsResponse AWS API Documentation
+    #
+    class ListParticipantsResponse < Struct.new(
+      :next_token,
+      :participants)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] max_results
+    #   Maximum number of results to return. Default: 50.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   The first stage to retrieve. This is used for pagination; see the
+    #   `nextToken` response field.
+    #   @return [String]
+    #
+    # @!attribute [rw] stage_arn
+    #   Stage ARN.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ListStageSessionsRequest AWS API Documentation
+    #
+    class ListStageSessionsRequest < Struct.new(
+      :max_results,
+      :next_token,
+      :stage_arn)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] next_token
+    #   If there are more rooms than `maxResults`, use `nextToken` in the
+    #   request to get the next set.
+    #   @return [String]
+    #
+    # @!attribute [rw] stage_sessions
+    #   List of matching stage sessions.
+    #   @return [Array<Types::StageSessionSummary>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ListStageSessionsResponse AWS API Documentation
+    #
+    class ListStageSessionsResponse < Struct.new(
+      :next_token,
+      :stage_sessions)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] max_results
     #   Maximum number of results to return. Default: 50.
     #   @return [Integer]
@@ -276,6 +547,95 @@ module Aws::IVSRealTime
       include Aws::Structure
     end
 
+    # Object describing a participant that has joined a stage.
+    #
+    # @!attribute [rw] attributes
+    #   Application-provided attributes to encode into the token and attach
+    #   to a stage. Map keys and values can contain UTF-8 encoded text. The
+    #   maximum length of this field is 1 KB total. *This field is exposed
+    #   to all stage participants and should not be used for personally
+    #   identifying, confidential, or sensitive information*.
+    #   @return [Hash<String,String>]
+    #
+    # @!attribute [rw] first_join_time
+    #   ISO 8601 timestamp (returned as a string) when the participant first
+    #   joined the stage session.
+    #   @return [Time]
+    #
+    # @!attribute [rw] participant_id
+    #   Unique identifier for this participant, assigned by IVS.
+    #   @return [String]
+    #
+    # @!attribute [rw] published
+    #   Whether the participant ever published to the stage session.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] state
+    #   Whether the participant is connected to or disconnected from the
+    #   stage.
+    #   @return [String]
+    #
+    # @!attribute [rw] user_id
+    #   Customer-assigned name to help identify the token; this can be used
+    #   to link a participant to a user in the customer’s own systems. This
+    #   can be any UTF-8 encoded text. *This field is exposed to all stage
+    #   participants and should not be used for personally identifying,
+    #   confidential, or sensitive information*.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/Participant AWS API Documentation
+    #
+    class Participant < Struct.new(
+      :attributes,
+      :first_join_time,
+      :participant_id,
+      :published,
+      :state,
+      :user_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Summary object describing a participant that has joined a stage.
+    #
+    # @!attribute [rw] first_join_time
+    #   ISO 8601 timestamp (returned as a string) when the participant first
+    #   joined the stage session.
+    #   @return [Time]
+    #
+    # @!attribute [rw] participant_id
+    #   Unique identifier for this participant, assigned by IVS.
+    #   @return [String]
+    #
+    # @!attribute [rw] published
+    #   Whether the participant ever published to the stage session.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] state
+    #   Whether the participant is connected to or disconnected from the
+    #   stage.
+    #   @return [String]
+    #
+    # @!attribute [rw] user_id
+    #   Customer-assigned name to help identify the token; this can be used
+    #   to link a participant to a user in the customer’s own systems. This
+    #   can be any UTF-8 encoded text. *This field is exposed to all stage
+    #   participants and should not be used for personally identifying,
+    #   confidential, or sensitive information*.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ParticipantSummary AWS API Documentation
+    #
+    class ParticipantSummary < Struct.new(
+      :first_join_time,
+      :participant_id,
+      :published,
+      :state,
+      :user_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Object specifying a participant token in a stage.
     #
     # @!attribute [rw] attributes
@@ -292,7 +652,7 @@ module Aws::IVSRealTime
     #
     # @!attribute [rw] duration
     #   Duration (in minutes), after which the participant token expires.
-    #   Default: 60 (1 hour).
+    #   Default: 720 (12 hours).
     #   @return [Integer]
     #
     # @!attribute [rw] expiration_time
@@ -309,10 +669,11 @@ module Aws::IVSRealTime
     #   @return [String]
     #
     # @!attribute [rw] user_id
-    #   Name to help identify the token. This can be any UTF-8 encoded text.
-    #   *This field is exposed to all stage participants and should not be
-    #   used for personally identifying, confidential, or sensitive
-    #   information.*
+    #   Customer-assigned name to help identify the token; this can be used
+    #   to link a participant to a user in the customer’s own systems. This
+    #   can be any UTF-8 encoded text. *This field is exposed to all stage
+    #   participants and should not be used for personally identifying,
+    #   confidential, or sensitive information.*
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ParticipantToken AWS API Documentation
@@ -347,14 +708,15 @@ module Aws::IVSRealTime
     #
     # @!attribute [rw] duration
     #   Duration (in minutes), after which the corresponding participant
-    #   token expires. Default: 60 (1 hour).
+    #   token expires. Default: 720 (12 hours).
     #   @return [Integer]
     #
     # @!attribute [rw] user_id
-    #   Name that can be specified to help identify the corresponding
-    #   participant token. This can be any UTF-8 encoded text. *This field
-    #   is exposed to all stage participants and should not be used for
-    #   personally identifying, confidential, or sensitive information.*
+    #   Customer-assigned name to help identify the token; this can be used
+    #   to link a participant to a user in the customer’s own systems. This
+    #   can be any UTF-8 encoded text. *This field is exposed to all stage
+    #   participants and should not be used for personally identifying,
+    #   confidential, or sensitive information.*
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/ParticipantTokenConfiguration AWS API Documentation
@@ -441,6 +803,62 @@ module Aws::IVSRealTime
       include Aws::Structure
     end
 
+    # A stage session begins when the first participant joins a stage and
+    # ends after the last participant leaves the stage. A stage session
+    # helps with debugging stages by grouping events and participants into
+    # shorter periods of time (i.e., a session), which is helpful when
+    # stages are used over long periods of time.
+    #
+    # @!attribute [rw] end_time
+    #   ISO 8601 timestamp (returned as a string) when the stage session
+    #   ended. This is null if the stage is active.
+    #   @return [Time]
+    #
+    # @!attribute [rw] session_id
+    #   ID of the session within the stage.
+    #   @return [String]
+    #
+    # @!attribute [rw] start_time
+    #   ISO 8601 timestamp (returned as a string) when this stage session
+    #   began.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/StageSession AWS API Documentation
+    #
+    class StageSession < Struct.new(
+      :end_time,
+      :session_id,
+      :start_time)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Summary information about a stage session.
+    #
+    # @!attribute [rw] end_time
+    #   ISO 8601 timestamp (returned as a string) when the stage session
+    #   ended. This is null if the stage is active.
+    #   @return [Time]
+    #
+    # @!attribute [rw] session_id
+    #   ID of the session within the stage.
+    #   @return [String]
+    #
+    # @!attribute [rw] start_time
+    #   ISO 8601 timestamp (returned as a string) when this stage session
+    #   began.
+    #   @return [Time]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/ivs-realtime-2020-07-14/StageSessionSummary AWS API Documentation
+    #
+    class StageSessionSummary < Struct.new(
+      :end_time,
+      :session_id,
+      :start_time)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Summary information about a stage.
     #
     # @!attribute [rw] active_session_id

data/lib/aws-sdk-ivsrealtime.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-ivsrealtime/customizations'
 # @!group service
 module Aws::IVSRealTime
 
-  GEM_VERSION = '1.1.0'
+  GEM_VERSION = '1.2.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-ivsrealtime
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-04-05 00:00:00.000000000 Z
+date: 2023-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core