String exceptionMessage
User does not have sufficient access to perform this action.
String channelArn
ARN of the channel to use for broadcasting. The channel and stage resources must be in the same AWS account and region. The channel must be offline (not broadcasting).
String encoderConfigurationArn
ARN of the EncoderConfiguration resource. The encoder configuration and stage resources must be in the same AWS account and region.
String arn
ARN of the Composition resource.
List<E> destinations
Array of Destination objects. A Composition can contain either one destination (channel or
s3) or two (one channel and one s3).
Date endTime
UTC time of the Composition end. This is an ISO 8601 timestamp; note that this is returned as a string.
LayoutConfiguration layout
Layout object to configure composition parameters.
String stageArn
ARN of the stage used as input
Date startTime
UTC time of the Composition start. This is an ISO 8601 timestamp; note that this is returned as a string.
String state
State of the Composition.
Map<K,V> tags
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.
String arn
ARN of the Composition resource.
List<E> destinations
Array of Destination objects.
Date endTime
UTC time of the Composition end. This is an ISO 8601 timestamp; note that this is returned as a string.
String stageArn
ARN of the attached stage.
Date startTime
UTC time of the Composition start. This is an ISO 8601 timestamp; note that this is returned as a string.
String state
State of the Composition resource.
Map<K,V> tags
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.
String exceptionMessage
Updating or deleting a resource can cause an inconsistent state.
String name
Optional name to identify the resource.
Map<K,V> tags
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.
Video video
Video configuration. Default: video resolution 1280x720, bitrate 2500 kbps, 30 fps.
EncoderConfiguration encoderConfiguration
The EncoderConfiguration that was created.
Map<K,V> 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.
List<E> capabilities
Set of capabilities that the user is allowed to perform in the stage. Default: PUBLISH, SUBSCRIBE.
Integer duration
Duration (in minutes), after which the token expires. Default: 720 (12 hours).
String stageArn
ARN of the stage to which this token is scoped.
String userId
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.
ParticipantToken participantToken
The participant token that was created.
String name
Optional name that can be specified for the stage being created.
List<E> participantTokenConfigurations
Array of participant token configuration objects to attach to the new stage.
Map<K,V> tags
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.
String name
Storage configuration name. The value does not need to be unique.
S3StorageConfiguration s3
A complex type that contains a storage configuration for where recorded video will be stored.
Map<K,V> tags
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.
StorageConfiguration storageConfiguration
The StorageConfiguration that was created.
String arn
ARN of the EncoderConfiguration.
String arn
ARN of the stage to be deleted.
String arn
ARN of the storage configuration to be deleted.
DestinationConfiguration configuration
Configuration used to create this destination.
DestinationDetail detail
Optional details regarding the status of the destination.
Date endTime
UTC time of the destination end. This is an ISO 8601 timestamp; note that this is returned as a string.
String id
Unique identifier for this destination, assigned by IVS.
Date startTime
UTC time of the destination start. This is an ISO 8601 timestamp; note that this is returned as a string.
String state
State of the Composition Destination.
ChannelDestinationConfiguration channel
An IVS channel to be used for broadcasting, for server-side composition. Either a channel or an
s3 must be specified.
String name
Name that can be specified to help identify the destination.
S3DestinationConfiguration s3
An S3 storage configuration to be used for recording video data. Either a channel or an
s3 must be specified.
S3Detail s3
An S3 detail object to return information about the S3 destination.
Date endTime
UTC time of the destination end. This is an ISO 8601 timestamp; note that this is returned as a string.
String id
Unique identifier for this destination, assigned by IVS.
Date startTime
UTC time of the destination start. This is an ISO 8601 timestamp; note that this is returned as a string.
String state
State of the Composition Destination.
String participantId
Identifier of the participant to be disconnected. This is assigned by IVS and returned by CreateParticipantToken.
String reason
Description of why this participant is being disconnected.
String stageArn
ARN of the stage to which the participant is attached.
String arn
ARN of the EncoderConfiguration resource.
String name
Optional name to identify the resource.
Map<K,V> tags
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.
Video video
Video configuration. Default: video resolution 1280x720, bitrate 2500 kbps, 30 fps
String arn
ARN of the EncoderConfiguration resource.
String name
Optional name to identify the resource.
Map<K,V> tags
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.
String errorCode
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.
Date eventTime
ISO 8601 timestamp (returned as a string) for when the event occurred.
String name
The name of the event.
String participantId
Unique identifier for the participant who triggered the event. This is assigned by IVS.
String remoteParticipantId
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.
String arn
ARN of the Composition resource.
Composition composition
The Composition that was returned.
String arn
ARN of the EncoderConfiguration resource.
EncoderConfiguration encoderConfiguration
The EncoderConfiguration that was returned.
String participantId
Unique identifier for the participant. This is assigned by IVS and returned by CreateParticipantToken.
String sessionId
ID of a session within the stage.
String stageArn
Stage ARN.
Participant participant
The participant that is returned.
String arn
ARN of the stage for which the information is to be retrieved.
Stage stage
The stage that is returned.
StageSession stageSession
The stage session that is returned.
String arn
ARN of the storage configuration to be retrieved.
StorageConfiguration storageConfiguration
The StorageConfiguration that was returned.
String featuredParticipantAttribute
This attribute name identifies the featured slot. A participant with this attribute set to "true"
(as a string value) in ParticipantTokenConfiguration is placed in the featured slot.
Integer gridGap
Specifies the spacing between participant tiles in pixels. Default: 2.
Boolean omitStoppedVideo
Determines whether to omit participants with stopped video in the composition. Default: false.
String videoAspectRatio
Sets the non-featured participant display mode. Default: VIDEO.
String videoFillMode
Defines how video fits within the participant tile. When not set, videoFillMode defaults to
COVER fill mode for participants in the grid and to CONTAIN fill mode for featured
participants.
String exceptionMessage
Unexpected error during processing of request.
GridConfiguration grid
Configuration related to grid layout. Default: Grid layout.
PipConfiguration pip
Configuration related to PiP layout.
String filterByEncoderConfigurationArn
Filters the Composition list to match the specified EncoderConfiguration attached to at least one of its output.
String filterByStageArn
Filters the Composition list to match the specified Stage ARN.
Integer maxResults
Maximum number of results to return. Default: 100.
String nextToken
The first Composition to retrieve. This is used for pagination; see the nextToken response field.
Integer maxResults
Maximum number of results to return. Default: 50.
String nextToken
The first participant event to retrieve. This is used for pagination; see the nextToken response
field.
String participantId
Unique identifier for this participant. This is assigned by IVS and returned by CreateParticipantToken.
String sessionId
ID of a session within the stage.
String stageArn
Stage ARN.
Boolean filterByPublished
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.
String filterByState
Filters the response list to only show participants in the specified state. Only one of
filterByUserId, filterByPublished, or filterByState can be provided per
request.
String filterByUserId
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.
Integer maxResults
Maximum number of results to return. Default: 50.
String nextToken
The first participant to retrieve. This is used for pagination; see the nextToken response field.
String sessionId
ID of the session within the stage.
String stageArn
Stage ARN.
String resourceArn
The ARN of the resource to be retrieved. The ARN must be URL-encoded.
Map<K,V> 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.
String browserName
The participant’s browser.
String browserVersion
The participant’s browser version.
Date firstJoinTime
ISO 8601 timestamp (returned as a string) when the participant first joined the stage session.
String ispName
The participant’s Internet Service Provider.
String osName
The participant’s operating system.
String osVersion
The participant’s operating system version.
String participantId
Unique identifier for this participant, assigned by IVS.
Boolean published
Whether the participant ever published to the stage session.
String sdkVersion
The participant’s SDK version.
String state
Whether the participant is connected to or disconnected from the stage.
String userId
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.
Date firstJoinTime
ISO 8601 timestamp (returned as a string) when the participant first joined the stage session.
String participantId
Unique identifier for this participant, assigned by IVS.
Boolean published
Whether the participant ever published to the stage session.
String state
Whether the participant is connected to or disconnected from the stage.
String userId
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.
Map<K,V> attributes
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.
List<E> capabilities
Set of capabilities that the user is allowed to perform in the stage.
Integer duration
Duration (in minutes), after which the participant token expires. Default: 720 (12 hours).
Date expirationTime
ISO 8601 timestamp (returned as a string) for when this token expires.
String participantId
Unique identifier for this participant token, assigned by IVS.
String token
The issued client token, encrypted.
String userId
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.
Map<K,V> attributes
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.
List<E> capabilities
Set of capabilities that the user is allowed to perform in the stage.
Integer duration
Duration (in minutes), after which the corresponding participant token expires. Default: 720 (12 hours).
String userId
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.
String exceptionMessage
Your account is pending verification.
String featuredParticipantAttribute
This attribute name identifies the featured slot. A participant with this attribute set to "true"
(as a string value) in ParticipantTokenConfiguration is placed in the featured slot.
Integer gridGap
Specifies the spacing between participant tiles in pixels. Default: 0.
Boolean omitStoppedVideo
Determines whether to omit participants with stopped video in the composition. Default: false.
String pipBehavior
Defines PiP behavior when all participants have left. Default: STATIC.
Integer pipHeight
Specifies the height of the PiP window in pixels. When this is not set explicitly, pipHeight’s value
will be based on the size of the composition and the aspect ratio of the participant’s video.
Integer pipOffset
Sets the PiP window’s offset position in pixels from the closest edges determined by PipPosition.
Default: 0.
String pipParticipantAttribute
Identifies the PiP slot. A participant with this attribute set to "true" (as a string value) in
ParticipantTokenConfiguration is placed in the PiP slot.
String pipPosition
Determines the corner position of the PiP window. Default: BOTTOM_RIGHT.
Integer pipWidth
Specifies the width of the PiP window in pixels. When this is not set explicitly, pipWidth’s value
will be based on the size of the composition and the aspect ratio of the participant’s video.
String videoFillMode
Defines how video fits within the participant tile. Default: COVER.
String format
The recording format for storing a recording in Amazon S3.
String exceptionMessage
Request references a resource which does not exist.
List<E> encoderConfigurationArns
ARNs of the EncoderConfiguration resource. The encoder configuration and stage resources must be in the same AWS account and region.
RecordingConfiguration recordingConfiguration
Array of maps, each of the form string:string (key:value). This is an optional customer
specification, currently used only to specify the recording format for storing a recording in Amazon S3.
String storageConfigurationArn
ARN of the StorageConfiguration where recorded videos will be stored.
String recordingPrefix
The S3 bucket prefix under which the recording is stored.
String bucketName
Location (S3 bucket name) where recorded videos will be stored. Note that the StorageConfiguration and S3 bucket must be in the same region as the Composition.
String exceptionMessage
Request would cause a service quota to be exceeded.
String activeSessionId
ID of the active session within the stage.
String arn
Stage ARN.
String name
Stage name.
Map<K,V> tags
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.
String activeSessionId
ID of the active session within the stage.
String arn
Stage ARN.
String name
Stage name.
Map<K,V> tags
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.
List<E> destinations
Array of destination configuration.
String idempotencyToken
Idempotency token.
LayoutConfiguration layout
Layout object to configure composition parameters.
String stageArn
ARN of the stage to be used for compositing.
Map<K,V> tags
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.
Composition composition
The Composition that was created.
String arn
ARN of the Composition.
String arn
ARN of the storage configuration.
String name
Name of the storage configuration.
S3StorageConfiguration s3
An S3 destination configuration where recorded videos will be stored.
Map<K,V> tags
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.
String arn
ARN of the storage configuration.
String name
Name of the storage configuration.
S3StorageConfiguration s3
An S3 destination configuration where recorded videos will be stored.
Map<K,V> tags
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.
String resourceArn
The ARN of the resource to be tagged. The ARN must be URL-encoded.
Map<K,V> tags
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.
String resourceArn
The ARN of the resource to be untagged. The ARN must be URL-encoded.
List<E> tagKeys
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.
Stage stage
The updated stage.
String exceptionMessage
The input fails to satisfy the constraints specified by an Amazon Web Services service.
Integer bitrate
Bitrate for generated output, in bps. Default: 2500000.
Float framerate
Video frame rate, in fps. Default: 30.
Integer height
Video-resolution height. Note that the maximum value is determined by width times
height, such that the maximum total pixels is 2073600 (1920x1080 or 1080x1920). Default: 720.
Integer width
Video-resolution width. Note that the maximum value is determined by width times height
, such that the maximum total pixels is 2073600 (1920x1080 or 1080x1920). Default: 1280.
Copyright © 2024. All rights reserved.