Creates an additional token for a specified stage. This can be done after stage creation or when tokens expire. Tokens always are scoped to the stage for which they are created.
Encryption keys are owned by Amazon IVS and never used directly by your application.
" }, "CreateStage":{ "name":"CreateStage", "http":{ "method":"POST", "requestUri":"/CreateStage", "responseCode":200 }, "input":{"shape":"CreateStageRequest"}, "output":{"shape":"CreateStageResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"PendingVerification"} ], "documentation":"Creates a new stage (and optionally participant tokens).
" }, "DeleteStage":{ "name":"DeleteStage", "http":{ "method":"POST", "requestUri":"/DeleteStage", "responseCode":200 }, "input":{"shape":"DeleteStageRequest"}, "output":{"shape":"DeleteStageResponse"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, {"shape":"ConflictException"}, {"shape":"PendingVerification"} ], "documentation":"Shuts down and deletes the specified stage (disconnecting all participants).
" }, "DisconnectParticipant":{ "name":"DisconnectParticipant", "http":{ "method":"POST", "requestUri":"/DisconnectParticipant", "responseCode":200 }, "input":{"shape":"DisconnectParticipantRequest"}, "output":{"shape":"DisconnectParticipantResponse"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, {"shape":"PendingVerification"} ], "documentation":"Disconnects a specified participant and revokes the participant permanently from a specified stage.
" }, "GetParticipant":{ "name":"GetParticipant", "http":{ "method":"POST", "requestUri":"/GetParticipant", "responseCode":200 }, "input":{"shape":"GetParticipantRequest"}, "output":{"shape":"GetParticipantResponse"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"ValidationException"}, {"shape":"AccessDeniedException"} ], "documentation":"Gets information about the specified participant token.
" }, "GetStage":{ "name":"GetStage", "http":{ "method":"POST", "requestUri":"/GetStage", "responseCode":200 }, "input":{"shape":"GetStageRequest"}, "output":{"shape":"GetStageResponse"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"ValidationException"}, {"shape":"AccessDeniedException"} ], "documentation":"Gets information for the specified stage.
" }, "GetStageSession":{ "name":"GetStageSession", "http":{ "method":"POST", "requestUri":"/GetStageSession", "responseCode":200 }, "input":{"shape":"GetStageSessionRequest"}, "output":{"shape":"GetStageSessionResponse"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"ValidationException"}, {"shape":"AccessDeniedException"} ], "documentation":"Gets information for the specified stage session.
" }, "ListParticipantEvents":{ "name":"ListParticipantEvents", "http":{ "method":"POST", "requestUri":"/ListParticipantEvents", "responseCode":200 }, "input":{"shape":"ListParticipantEventsRequest"}, "output":{"shape":"ListParticipantEventsResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"AccessDeniedException"} ], "documentation":"Lists events for a specified participant that occurred during a specified stage session.
" }, "ListParticipants":{ "name":"ListParticipants", "http":{ "method":"POST", "requestUri":"/ListParticipants", "responseCode":200 }, "input":{"shape":"ListParticipantsRequest"}, "output":{"shape":"ListParticipantsResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"AccessDeniedException"} ], "documentation":"Lists all participants in a specified stage session.
" }, "ListStageSessions":{ "name":"ListStageSessions", "http":{ "method":"POST", "requestUri":"/ListStageSessions", "responseCode":200 }, "input":{"shape":"ListStageSessionsRequest"}, "output":{"shape":"ListStageSessionsResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"AccessDeniedException"} ], "documentation":"Gets all sessions for a specified stage.
" }, "ListStages":{ "name":"ListStages", "http":{ "method":"POST", "requestUri":"/ListStages", "responseCode":200 }, "input":{"shape":"ListStagesRequest"}, "output":{"shape":"ListStagesResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, {"shape":"ConflictException"} ], "documentation":"Gets summary information about all stages in your account, in the AWS region where the API request is processed.
" }, "ListTagsForResource":{ "name":"ListTagsForResource", "http":{ "method":"GET", "requestUri":"/tags/{resourceArn}", "responseCode":200 }, "input":{"shape":"ListTagsForResourceRequest"}, "output":{"shape":"ListTagsForResourceResponse"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"ValidationException"}, {"shape":"InternalServerException"} ], "documentation":"Gets information about AWS tags for the specified ARN.
" }, "TagResource":{ "name":"TagResource", "http":{ "method":"POST", "requestUri":"/tags/{resourceArn}", "responseCode":200 }, "input":{"shape":"TagResourceRequest"}, "output":{"shape":"TagResourceResponse"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"ValidationException"}, {"shape":"InternalServerException"} ], "documentation":"Adds or updates tags for the AWS resource with the specified ARN.
" }, "UntagResource":{ "name":"UntagResource", "http":{ "method":"DELETE", "requestUri":"/tags/{resourceArn}", "responseCode":200 }, "input":{"shape":"UntagResourceRequest"}, "output":{"shape":"UntagResourceResponse"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"ValidationException"}, {"shape":"InternalServerException"} ], "documentation":"Removes tags from the resource with the specified ARN.
", "idempotent":true }, "UpdateStage":{ "name":"UpdateStage", "http":{ "method":"POST", "requestUri":"/UpdateStage", "responseCode":200 }, "input":{"shape":"UpdateStageRequest"}, "output":{"shape":"UpdateStageResponse"}, "errors":[ {"shape":"ResourceNotFoundException"}, {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"PendingVerification"} ], "documentation":"Updates a stage’s configuration.
" } }, "shapes":{ "AccessDeniedException":{ "type":"structure", "members":{ "exceptionMessage":{ "shape":"errorMessage", "documentation":"User does not have sufficient access to perform this action.
" } }, "documentation":"", "error":{ "httpStatusCode":403, "senderFault":true }, "exception":true }, "ConflictException":{ "type":"structure", "members":{ "exceptionMessage":{ "shape":"errorMessage", "documentation":"Updating or deleting a resource can cause an inconsistent state.
" } }, "documentation":"", "error":{ "httpStatusCode":409, "senderFault":true }, "exception":true }, "CreateParticipantTokenRequest":{ "type":"structure", "required":["stageArn"], "members":{ "attributes":{ "shape":"ParticipantTokenAttributes", "documentation":"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.
" }, "capabilities":{ "shape":"ParticipantTokenCapabilities", "documentation":"Set of capabilities that the user is allowed to perform in the stage. Default: PUBLISH, SUBSCRIBE.
Duration (in minutes), after which the token expires. Default: 720 (12 hours).
" }, "stageArn":{ "shape":"StageArn", "documentation":"ARN of the stage to which this token is scoped.
" }, "userId":{ "shape":"ParticipantTokenUserId", "documentation":"Name that can be specified 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.
" } } }, "CreateParticipantTokenResponse":{ "type":"structure", "members":{ "participantToken":{ "shape":"ParticipantToken", "documentation":"The participant token that was created.
" } } }, "CreateStageRequest":{ "type":"structure", "members":{ "name":{ "shape":"StageName", "documentation":"Optional name that can be specified for the stage being created.
" }, "participantTokenConfigurations":{ "shape":"ParticipantTokenConfigurations", "documentation":"Array of participant token configuration objects to attach to the new stage.
" }, "tags":{ "shape":"Tags", "documentation":"Tags attached to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.
Participant tokens attached to the stage. These correspond to the participants in the request.
The stage that was created.
" } } }, "DeleteStageRequest":{ "type":"structure", "required":["arn"], "members":{ "arn":{ "shape":"StageArn", "documentation":"ARN of the stage to be deleted.
" } } }, "DeleteStageResponse":{ "type":"structure", "members":{ } }, "DisconnectParticipantReason":{ "type":"string", "max":128, "min":0 }, "DisconnectParticipantRequest":{ "type":"structure", "required":[ "participantId", "stageArn" ], "members":{ "participantId":{ "shape":"ParticipantTokenId", "documentation":"Identifier of the participant to be disconnected. This is assigned by IVS and returned by CreateParticipantToken.
" }, "reason":{ "shape":"DisconnectParticipantReason", "documentation":"Description of why this participant is being disconnected.
" }, "stageArn":{ "shape":"StageArn", "documentation":"ARN of the stage to which the participant is attached.
" } } }, "DisconnectParticipantResponse":{ "type":"structure", "members":{ } }, "Event":{ "type":"structure", "members":{ "errorCode":{ "shape":"EventErrorCode", "documentation":"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. QUOTA_EXCEEDED indicates that the number of participants who want to publish/subscribe to a stage exceeds the quota; for more information, see Service Quotas. PUBLISHER_NOT_FOUND indicates that the participant tried to subscribe to a publisher that doesn’t exist.
ISO 8601 timestamp (returned as a string) for when the event occurred.
" }, "name":{ "shape":"EventName", "documentation":"The name of the event.
" }, "participantId":{ "shape":"ParticipantId", "documentation":"Unique identifier for the participant who triggered the event. This is assigned by IVS.
" }, "remoteParticipantId":{ "shape":"ParticipantId", "documentation":"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.
" } }, "documentation":"An occurrence during a stage session.
" }, "EventErrorCode":{ "type":"string", "enum":[ "INSUFFICIENT_CAPABILITIES", "QUOTA_EXCEEDED", "PUBLISHER_NOT_FOUND" ] }, "EventList":{ "type":"list", "member":{"shape":"Event"} }, "EventName":{ "type":"string", "enum":[ "JOINED", "LEFT", "PUBLISH_STARTED", "PUBLISH_STOPPED", "SUBSCRIBE_STARTED", "SUBSCRIBE_STOPPED", "PUBLISH_ERROR", "SUBSCRIBE_ERROR", "JOIN_ERROR" ] }, "GetParticipantRequest":{ "type":"structure", "required":[ "participantId", "sessionId", "stageArn" ], "members":{ "participantId":{ "shape":"ParticipantId", "documentation":"Unique identifier for the participant. This is assigned by IVS and returned by CreateParticipantToken.
" }, "sessionId":{ "shape":"StageSessionId", "documentation":"ID of a session within the stage.
" }, "stageArn":{ "shape":"StageArn", "documentation":"Stage ARN.
" } } }, "GetParticipantResponse":{ "type":"structure", "members":{ "participant":{ "shape":"Participant", "documentation":"The participant that is returned.
" } } }, "GetStageRequest":{ "type":"structure", "required":["arn"], "members":{ "arn":{ "shape":"StageArn", "documentation":"ARN of the stage for which the information is to be retrieved.
" } } }, "GetStageResponse":{ "type":"structure", "members":{ "stage":{ "shape":"Stage", "documentation":"The stage that is returned.
" } } }, "GetStageSessionRequest":{ "type":"structure", "required":[ "sessionId", "stageArn" ], "members":{ "sessionId":{ "shape":"StageSessionId", "documentation":"ID of a session within the stage.
" }, "stageArn":{ "shape":"StageArn", "documentation":"ARN of the stage for which the information is to be retrieved.
" } } }, "GetStageSessionResponse":{ "type":"structure", "members":{ "stageSession":{ "shape":"StageSession", "documentation":"The stage session that is returned.
" } } }, "InternalServerException":{ "type":"structure", "members":{ "exceptionMessage":{ "shape":"errorMessage", "documentation":"Unexpected error during processing of request.
" } }, "documentation":"", "error":{"httpStatusCode":500}, "exception":true, "fault":true }, "ListParticipantEventsRequest":{ "type":"structure", "required":[ "participantId", "sessionId", "stageArn" ], "members":{ "maxResults":{ "shape":"MaxParticipantEventResults", "documentation":"Maximum number of results to return. Default: 50.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The first participant to retrieve. This is used for pagination; see the nextToken response field.
Unique identifier for this participant. This is assigned by IVS and returned by CreateParticipantToken.
" }, "sessionId":{ "shape":"StageSessionId", "documentation":"ID of a session within the stage.
" }, "stageArn":{ "shape":"StageArn", "documentation":"Stage ARN.
" } } }, "ListParticipantEventsResponse":{ "type":"structure", "required":["events"], "members":{ "events":{ "shape":"EventList", "documentation":"List of the matching events.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"If there are more rooms than maxResults, use nextToken in the request to get the next set.
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.
Filters the response list to only show participants in the specified state. Only one of filterByUserId, filterByPublished, or filterByState can be provided per request.
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.
Maximum number of results to return. Default: 50.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The first participant to retrieve. This is used for pagination; see the nextToken response field.
ID of the session within the stage.
" }, "stageArn":{ "shape":"StageArn", "documentation":"Stage ARN.
" } } }, "ListParticipantsResponse":{ "type":"structure", "required":["participants"], "members":{ "nextToken":{ "shape":"PaginationToken", "documentation":"If there are more rooms than maxResults, use nextToken in the request to get the next set.
List of the matching participants (summary information only).
" } } }, "ListStageSessionsRequest":{ "type":"structure", "required":["stageArn"], "members":{ "maxResults":{ "shape":"MaxStageSessionResults", "documentation":"Maximum number of results to return. Default: 50.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The first stage to retrieve. This is used for pagination; see the nextToken response field.
Stage ARN.
" } } }, "ListStageSessionsResponse":{ "type":"structure", "required":["stageSessions"], "members":{ "nextToken":{ "shape":"PaginationToken", "documentation":"If there are more rooms than maxResults, use nextToken in the request to get the next set.
List of matching stage sessions.
" } } }, "ListStagesRequest":{ "type":"structure", "members":{ "maxResults":{ "shape":"MaxStageResults", "documentation":"Maximum number of results to return. Default: 50.
" }, "nextToken":{ "shape":"PaginationToken", "documentation":"The first stage to retrieve. This is used for pagination; see the nextToken response field.
If there are more rooms than maxResults, use nextToken in the request to get the next set.
List of the matching stages (summary information only).
" } } }, "ListTagsForResourceRequest":{ "type":"structure", "required":["resourceArn"], "members":{ "resourceArn":{ "shape":"ResourceArn", "documentation":"The ARN of the resource to be retrieved. The ARN must be URL-encoded.
", "location":"uri", "locationName":"resourceArn" } } }, "ListTagsForResourceResponse":{ "type":"structure", "required":["tags"], "members":{ "tags":{ "shape":"Tags", "documentation":"Tags attached to the resource. Array of maps, each of the form string:string (key:value).
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.
" }, "browserName":{ "shape":"ParticipantClientAttribute", "documentation":"The participant’s browser.
" }, "browserVersion":{ "shape":"ParticipantClientAttribute", "documentation":"The participant’s browser version.
" }, "firstJoinTime":{ "shape":"Time", "documentation":"ISO 8601 timestamp (returned as a string) when the participant first joined the stage session.
" }, "ispName":{ "shape":"ParticipantClientAttribute", "documentation":"The participant’s Internet Service Provider.
" }, "osName":{ "shape":"ParticipantClientAttribute", "documentation":"The participant’s operating system.
" }, "osVersion":{ "shape":"ParticipantClientAttribute", "documentation":"The participant’s operating system version.
" }, "participantId":{ "shape":"ParticipantId", "documentation":"Unique identifier for this participant, assigned by IVS.
" }, "published":{ "shape":"Published", "documentation":"Whether the participant ever published to the stage session.
" }, "sdkVersion":{ "shape":"ParticipantClientAttribute", "documentation":"The participant’s SDK version.
" }, "state":{ "shape":"ParticipantState", "documentation":"Whether the participant is connected to or disconnected from the stage.
" }, "userId":{ "shape":"UserId", "documentation":"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.
" } }, "documentation":"Object describing a participant that has joined a stage.
" }, "ParticipantAttributes":{ "type":"map", "key":{"shape":"String"}, "value":{"shape":"String"} }, "ParticipantClientAttribute":{ "type":"string", "max":128, "min":0, "pattern":"^[a-zA-Z0-9-_.,:;\\s]*$" }, "ParticipantId":{"type":"string"}, "ParticipantList":{ "type":"list", "member":{"shape":"ParticipantSummary"} }, "ParticipantState":{ "type":"string", "enum":[ "CONNECTED", "DISCONNECTED" ] }, "ParticipantSummary":{ "type":"structure", "members":{ "firstJoinTime":{ "shape":"Time", "documentation":"ISO 8601 timestamp (returned as a string) when the participant first joined the stage session.
" }, "participantId":{ "shape":"ParticipantId", "documentation":"Unique identifier for this participant, assigned by IVS.
" }, "published":{ "shape":"Published", "documentation":"Whether the participant ever published to the stage session.
" }, "state":{ "shape":"ParticipantState", "documentation":"Whether the participant is connected to or disconnected from the stage.
" }, "userId":{ "shape":"UserId", "documentation":"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.
" } }, "documentation":"Summary object describing a participant that has joined a stage.
" }, "ParticipantToken":{ "type":"structure", "members":{ "attributes":{ "shape":"ParticipantTokenAttributes", "documentation":"Application-provided attributes to encode into the token and attach to a stage. This field is exposed to all stage participants and should not be used for personally identifying, confidential, or sensitive information.
" }, "capabilities":{ "shape":"ParticipantTokenCapabilities", "documentation":"Set of capabilities that the user is allowed to perform in the stage.
" }, "duration":{ "shape":"ParticipantTokenDurationMinutes", "documentation":"Duration (in minutes), after which the participant token expires. Default: 720 (12 hours).
" }, "expirationTime":{ "shape":"ParticipantTokenExpirationTime", "documentation":"ISO 8601 timestamp (returned as a string) for when this token expires.
" }, "participantId":{ "shape":"ParticipantTokenId", "documentation":"Unique identifier for this participant token, assigned by IVS.
" }, "token":{ "shape":"ParticipantTokenString", "documentation":"The issued client token, encrypted.
" }, "userId":{ "shape":"ParticipantTokenUserId", "documentation":"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.
" } }, "documentation":"Object specifying a participant token in a stage.
Important: Treat tokens as opaque; i.e., do not build functionality based on token contents. The format of tokens could change in the future.
" }, "ParticipantTokenAttributes":{ "type":"map", "key":{"shape":"String"}, "value":{"shape":"String"} }, "ParticipantTokenCapabilities":{ "type":"list", "member":{"shape":"ParticipantTokenCapability"}, "max":2, "min":0 }, "ParticipantTokenCapability":{ "type":"string", "enum":[ "PUBLISH", "SUBSCRIBE" ] }, "ParticipantTokenConfiguration":{ "type":"structure", "members":{ "attributes":{ "shape":"ParticipantTokenAttributes", "documentation":"Application-provided attributes to encode into the corresponding participant 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.
" }, "capabilities":{ "shape":"ParticipantTokenCapabilities", "documentation":"Set of capabilities that the user is allowed to perform in the stage.
" }, "duration":{ "shape":"ParticipantTokenDurationMinutes", "documentation":"Duration (in minutes), after which the corresponding participant token expires. Default: 720 (12 hours).
" }, "userId":{ "shape":"ParticipantTokenUserId", "documentation":"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.
" } }, "documentation":"Object specifying a participant token configuration in a stage.
" }, "ParticipantTokenConfigurations":{ "type":"list", "member":{"shape":"ParticipantTokenConfiguration"}, "max":12, "min":0 }, "ParticipantTokenDurationMinutes":{ "type":"integer", "max":20160, "min":1 }, "ParticipantTokenExpirationTime":{ "type":"timestamp", "timestampFormat":"iso8601" }, "ParticipantTokenId":{"type":"string"}, "ParticipantTokenList":{ "type":"list", "member":{"shape":"ParticipantToken"} }, "ParticipantTokenString":{ "type":"string", "sensitive":true }, "ParticipantTokenUserId":{ "type":"string", "max":128, "min":0 }, "PendingVerification":{ "type":"structure", "members":{ "exceptionMessage":{ "shape":"errorMessage", "documentation":"Your account is pending verification.
" } }, "documentation":"", "error":{ "httpStatusCode":403, "senderFault":true }, "exception":true }, "Published":{"type":"boolean"}, "ResourceArn":{ "type":"string", "max":128, "min":1, "pattern":"^arn:aws:[is]vs:[a-z0-9-]+:[0-9]+:[a-z-]/[a-zA-Z0-9-]+$" }, "ResourceNotFoundException":{ "type":"structure", "members":{ "exceptionMessage":{ "shape":"errorMessage", "documentation":"Request references a resource which does not exist.
" } }, "documentation":"", "error":{ "httpStatusCode":404, "senderFault":true }, "exception":true }, "ServiceQuotaExceededException":{ "type":"structure", "members":{ "exceptionMessage":{ "shape":"errorMessage", "documentation":"Request would cause a service quota to be exceeded.
" } }, "documentation":"", "error":{ "httpStatusCode":402, "senderFault":true }, "exception":true }, "Stage":{ "type":"structure", "required":["arn"], "members":{ "activeSessionId":{ "shape":"StageSessionId", "documentation":"ID of the active session within the stage.
" }, "arn":{ "shape":"StageArn", "documentation":"Stage ARN.
" }, "name":{ "shape":"StageName", "documentation":"Stage name.
" }, "tags":{ "shape":"Tags", "documentation":"Tags attached to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.
Object specifying a stage.
" }, "StageArn":{ "type":"string", "max":128, "min":1, "pattern":"^arn:aws:ivs:[a-z0-9-]+:[0-9]+:stage/[a-zA-Z0-9-]+$" }, "StageName":{ "type":"string", "max":128, "min":0, "pattern":"^[a-zA-Z0-9-_]*$" }, "StageSession":{ "type":"structure", "members":{ "endTime":{ "shape":"Time", "documentation":"ISO 8601 timestamp (returned as a string) when the stage session ended. This is null if the stage is active.
" }, "sessionId":{ "shape":"StageSessionId", "documentation":"ID of the session within the stage.
" }, "startTime":{ "shape":"Time", "documentation":"ISO 8601 timestamp (returned as a string) when this stage session began.
" } }, "documentation":"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.
" }, "StageSessionId":{ "type":"string", "max":16, "min":16, "pattern":"^st-[a-zA-Z0-9]+$" }, "StageSessionList":{ "type":"list", "member":{"shape":"StageSessionSummary"} }, "StageSessionSummary":{ "type":"structure", "members":{ "endTime":{ "shape":"Time", "documentation":"ISO 8601 timestamp (returned as a string) when the stage session ended. This is null if the stage is active.
" }, "sessionId":{ "shape":"StageSessionId", "documentation":"ID of the session within the stage.
" }, "startTime":{ "shape":"Time", "documentation":"ISO 8601 timestamp (returned as a string) when this stage session began.
" } }, "documentation":"Summary information about a stage session.
" }, "StageSummary":{ "type":"structure", "required":["arn"], "members":{ "activeSessionId":{ "shape":"StageSessionId", "documentation":"ID of the active session within the stage.
" }, "arn":{ "shape":"StageArn", "documentation":"Stage ARN.
" }, "name":{ "shape":"StageName", "documentation":"Stage name.
" }, "tags":{ "shape":"Tags", "documentation":"Tags attached to the resource. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints on tags beyond what is documented there.
Summary information about a stage.
" }, "StageSummaryList":{ "type":"list", "member":{"shape":"StageSummary"} }, "String":{"type":"string"}, "TagKey":{ "type":"string", "max":128, "min":1 }, "TagKeyList":{ "type":"list", "member":{"shape":"TagKey"}, "max":50, "min":0 }, "TagResourceRequest":{ "type":"structure", "required":[ "resourceArn", "tags" ], "members":{ "resourceArn":{ "shape":"ResourceArn", "documentation":"The ARN of the resource to be tagged. The ARN must be URL-encoded.
", "location":"uri", "locationName":"resourceArn" }, "tags":{ "shape":"Tags", "documentation":"Array of tags to be added or updated. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints beyond what is documented there.
The ARN of the resource to be untagged. The ARN must be URL-encoded.
", "location":"uri", "locationName":"resourceArn" }, "tagKeys":{ "shape":"TagKeyList", "documentation":"Array of tags to be removed. Array of maps, each of the form string:string (key:value). See Tagging AWS Resources for details, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS has no constraints beyond what is documented there.
ARN of the stage to be updated.
" }, "name":{ "shape":"StageName", "documentation":"Name of the stage to be updated.
" } } }, "UpdateStageResponse":{ "type":"structure", "members":{ "stage":{ "shape":"Stage", "documentation":"The updated stage.
" } } }, "UserId":{ "type":"string", "max":128, "min":0 }, "ValidationException":{ "type":"structure", "members":{ "exceptionMessage":{ "shape":"errorMessage", "documentation":"The input fails to satisfy the constraints specified by an Amazon Web Services service.
" } }, "documentation":"", "error":{ "httpStatusCode":400, "senderFault":true }, "exception":true }, "errorMessage":{"type":"string"} }, "documentation":"Introduction
The Amazon Interactive Video Service (IVS) real-time API is REST compatible, using a standard HTTP API and an AWS EventBridge event stream for responses. JSON is used for both requests and responses, including errors.
Terminology:
A stage is a virtual space where participants can exchange video in real time.
A participant token is a token that authenticates a participant when they join a stage.
A participant object represents participants (people) in the stage and contains information about them. When a token is created, it includes a participant ID; when a participant uses that token to join a stage, the participant is associated with that participant ID There is a 1:1 mapping between participant tokens and participants.
Resources
The following resources contain information about your IVS live stream (see Getting Started with Amazon IVS Real-Time Streaming):
Stage — A stage is a virtual space where participants can exchange video in real time.
Tagging
A tag is a metadata label that you assign to an AWS resource. A tag comprises a key and a value, both set by you. For example, you might set a tag as topic:nature to label a particular video category. See Tagging AWS Resources for more information, including restrictions that apply to tags and \"Tag naming limits and requirements\"; Amazon IVS stages has no service-specific constraints beyond what is documented there.
Tags can help you identify and organize your AWS resources. For example, you can use the same tag for different resources to indicate that they are related. You can also use tags to manage access (see Access Tags).
The Amazon IVS real-time API has these tag-related endpoints: TagResource, UntagResource, and ListTagsForResource. The following resource supports tagging: Stage.
At most 50 tags can be applied to a resource.
Stages Endpoints
CreateParticipantToken — Creates an additional token for a specified stage. This can be done after stage creation or when tokens expire.
CreateStage — Creates a new stage (and optionally participant tokens).
DeleteStage — Shuts down and deletes the specified stage (disconnecting all participants).
DisconnectParticipant — Disconnects a specified participant and revokes the participant permanently from a specified stage.
GetParticipant — Gets information about the specified participant token.
GetStage — Gets information for the specified stage.
GetStageSession — Gets information for the specified stage session.
ListParticipantEvents — Lists events for a specified participant that occurred during a specified stage session.
ListParticipants — Lists all participants in a specified stage session.
ListStages — Gets summary information about all stages in your account, in the AWS region where the API request is processed.
ListStageSessions — Gets all sessions for a specified stage.
UpdateStage — Updates a stage’s configuration.
Tags Endpoints
ListTagsForResource — Gets information about AWS tags for the specified ARN.
TagResource — Adds or updates tags for the AWS resource with the specified ARN.
UntagResource — Removes tags from the resource with the specified ARN.