Documentation ¶
Index ¶
- type AccessDeniedException
- type ConflictException
- type Event
- type EventErrorCode
- type EventName
- type InternalServerException
- type Participant
- type ParticipantState
- type ParticipantSummary
- type ParticipantToken
- type ParticipantTokenCapability
- type ParticipantTokenConfiguration
- type PendingVerification
- type ResourceNotFoundException
- type ServiceQuotaExceededException
- type Stage
- type StageSession
- type StageSessionSummary
- type StageSummary
- type ValidationException
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type AccessDeniedException ¶
type AccessDeniedException struct { Message *string ErrorCodeOverride *string ExceptionMessage *string // contains filtered or unexported fields }
func (*AccessDeniedException) Error ¶
func (e *AccessDeniedException) Error() string
func (*AccessDeniedException) ErrorCode ¶
func (e *AccessDeniedException) ErrorCode() string
func (*AccessDeniedException) ErrorFault ¶
func (e *AccessDeniedException) ErrorFault() smithy.ErrorFault
func (*AccessDeniedException) ErrorMessage ¶
func (e *AccessDeniedException) ErrorMessage() string
type ConflictException ¶
type ConflictException struct { Message *string ErrorCodeOverride *string ExceptionMessage *string // contains filtered or unexported fields }
func (*ConflictException) Error ¶
func (e *ConflictException) Error() string
func (*ConflictException) ErrorCode ¶
func (e *ConflictException) ErrorCode() string
func (*ConflictException) ErrorFault ¶
func (e *ConflictException) ErrorFault() smithy.ErrorFault
func (*ConflictException) ErrorMessage ¶
func (e *ConflictException) ErrorMessage() string
type Event ¶ added in v1.2.0
type Event struct { // 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 (https://docs.aws.amazon.com/ivs/latest/RealTimeUserGuide/service-quotas.html) // . PUBLISHER_NOT_FOUND indicates that the participant tried to subscribe to a // publisher that doesn’t exist. ErrorCode EventErrorCode // ISO 8601 timestamp (returned as a string) for when the event occurred. EventTime *time.Time // The name of the event. Name EventName // Unique identifier for the participant who triggered the event. This is assigned // by IVS. ParticipantId *string // 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. RemoteParticipantId *string // contains filtered or unexported fields }
An occurrence during a stage session.
type EventErrorCode ¶ added in v1.2.0
type EventErrorCode string
const ( EventErrorCodeInsufficientCapabilities EventErrorCode = "INSUFFICIENT_CAPABILITIES" EventErrorCodeQuotaExceeded EventErrorCode = "QUOTA_EXCEEDED" EventErrorCodePublisherNotFound EventErrorCode = "PUBLISHER_NOT_FOUND" )
Enum values for EventErrorCode
func (EventErrorCode) Values ¶ added in v1.2.0
func (EventErrorCode) Values() []EventErrorCode
Values returns all known values for EventErrorCode. Note that this can be expanded in the future, and so it is only as up to date as the client. The ordering of this slice is not guaranteed to be stable across updates.
type EventName ¶ added in v1.2.0
type EventName string
const ( EventNameJoined EventName = "JOINED" EventNameLeft EventName = "LEFT" EventNamePublishStarted EventName = "PUBLISH_STARTED" EventNamePublishStopped EventName = "PUBLISH_STOPPED" EventNameSubscribeStarted EventName = "SUBSCRIBE_STARTED" EventNameSubscribeStopped EventName = "SUBSCRIBE_STOPPED" EventNamePublishError EventName = "PUBLISH_ERROR" EventNameSubscribeError EventName = "SUBSCRIBE_ERROR" EventNameJoinError EventName = "JOIN_ERROR" )
Enum values for EventName
type InternalServerException ¶
type InternalServerException struct { Message *string ErrorCodeOverride *string ExceptionMessage *string // contains filtered or unexported fields }
func (*InternalServerException) Error ¶
func (e *InternalServerException) Error() string
func (*InternalServerException) ErrorCode ¶
func (e *InternalServerException) ErrorCode() string
func (*InternalServerException) ErrorFault ¶
func (e *InternalServerException) ErrorFault() smithy.ErrorFault
func (*InternalServerException) ErrorMessage ¶
func (e *InternalServerException) ErrorMessage() string
type Participant ¶ added in v1.2.0
type Participant struct { // 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. Attributes map[string]string // ISO 8601 timestamp (returned as a string) when the participant first joined the // stage session. FirstJoinTime *time.Time // Unique identifier for this participant, assigned by IVS. ParticipantId *string // Whether the participant ever published to the stage session. Published bool // Whether the participant is connected to or disconnected from the stage. State ParticipantState // 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. UserId *string // contains filtered or unexported fields }
Object describing a participant that has joined a stage.
type ParticipantState ¶ added in v1.2.0
type ParticipantState string
const ( ParticipantStateConnected ParticipantState = "CONNECTED" ParticipantStateDisconnected ParticipantState = "DISCONNECTED" )
Enum values for ParticipantState
func (ParticipantState) Values ¶ added in v1.2.0
func (ParticipantState) Values() []ParticipantState
Values returns all known values for ParticipantState. Note that this can be expanded in the future, and so it is only as up to date as the client. The ordering of this slice is not guaranteed to be stable across updates.
type ParticipantSummary ¶ added in v1.2.0
type ParticipantSummary struct { // ISO 8601 timestamp (returned as a string) when the participant first joined the // stage session. FirstJoinTime *time.Time // Unique identifier for this participant, assigned by IVS. ParticipantId *string // Whether the participant ever published to the stage session. Published bool // Whether the participant is connected to or disconnected from the stage. State ParticipantState // 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. UserId *string // contains filtered or unexported fields }
Summary object describing a participant that has joined a stage.
type ParticipantToken ¶
type ParticipantToken struct { // 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. Attributes map[string]string // Set of capabilities that the user is allowed to perform in the stage. Capabilities []ParticipantTokenCapability // Duration (in minutes), after which the participant token expires. Default: 720 // (12 hours). Duration int32 // ISO 8601 timestamp (returned as a string) for when this token expires. ExpirationTime *time.Time // Unique identifier for this participant token, assigned by IVS. ParticipantId *string // The issued client token, encrypted. Token *string // 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. UserId *string // contains filtered or unexported fields }
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.
type ParticipantTokenCapability ¶
type ParticipantTokenCapability string
const ( ParticipantTokenCapabilityPublish ParticipantTokenCapability = "PUBLISH" ParticipantTokenCapabilitySubscribe ParticipantTokenCapability = "SUBSCRIBE" )
Enum values for ParticipantTokenCapability
func (ParticipantTokenCapability) Values ¶
func (ParticipantTokenCapability) Values() []ParticipantTokenCapability
Values returns all known values for ParticipantTokenCapability. Note that this can be expanded in the future, and so it is only as up to date as the client. The ordering of this slice is not guaranteed to be stable across updates.
type ParticipantTokenConfiguration ¶
type ParticipantTokenConfiguration struct { // 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. Attributes map[string]string // Set of capabilities that the user is allowed to perform in the stage. Capabilities []ParticipantTokenCapability // Duration (in minutes), after which the corresponding participant token expires. // Default: 720 (12 hours). Duration int32 // 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. UserId *string // contains filtered or unexported fields }
Object specifying a participant token configuration in a stage.
type PendingVerification ¶
type PendingVerification struct { Message *string ErrorCodeOverride *string ExceptionMessage *string // contains filtered or unexported fields }
func (*PendingVerification) Error ¶
func (e *PendingVerification) Error() string
func (*PendingVerification) ErrorCode ¶
func (e *PendingVerification) ErrorCode() string
func (*PendingVerification) ErrorFault ¶
func (e *PendingVerification) ErrorFault() smithy.ErrorFault
func (*PendingVerification) ErrorMessage ¶
func (e *PendingVerification) ErrorMessage() string
type ResourceNotFoundException ¶
type ResourceNotFoundException struct { Message *string ErrorCodeOverride *string ExceptionMessage *string // contains filtered or unexported fields }
func (*ResourceNotFoundException) Error ¶
func (e *ResourceNotFoundException) Error() string
func (*ResourceNotFoundException) ErrorCode ¶
func (e *ResourceNotFoundException) ErrorCode() string
func (*ResourceNotFoundException) ErrorFault ¶
func (e *ResourceNotFoundException) ErrorFault() smithy.ErrorFault
func (*ResourceNotFoundException) ErrorMessage ¶
func (e *ResourceNotFoundException) ErrorMessage() string
type ServiceQuotaExceededException ¶
type ServiceQuotaExceededException struct { Message *string ErrorCodeOverride *string ExceptionMessage *string // contains filtered or unexported fields }
func (*ServiceQuotaExceededException) Error ¶
func (e *ServiceQuotaExceededException) Error() string
func (*ServiceQuotaExceededException) ErrorCode ¶
func (e *ServiceQuotaExceededException) ErrorCode() string
func (*ServiceQuotaExceededException) ErrorFault ¶
func (e *ServiceQuotaExceededException) ErrorFault() smithy.ErrorFault
func (*ServiceQuotaExceededException) ErrorMessage ¶
func (e *ServiceQuotaExceededException) ErrorMessage() string
type Stage ¶
type Stage struct { // Stage ARN. // // This member is required. Arn *string // ID of the active session within the stage. ActiveSessionId *string // Stage name. Name *string // Tags attached to the resource. Array of maps, each of the form string:string // (key:value) . See Tagging AWS Resources (https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) // 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. Tags map[string]string // contains filtered or unexported fields }
Object specifying a stage.
type StageSession ¶ added in v1.2.0
type StageSession struct { // ISO 8601 timestamp (returned as a string) when the stage session ended. This is // null if the stage is active. EndTime *time.Time // ID of the session within the stage. SessionId *string // ISO 8601 timestamp (returned as a string) when this stage session began. StartTime *time.Time // contains filtered or unexported fields }
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.
type StageSessionSummary ¶ added in v1.2.0
type StageSessionSummary struct { // ISO 8601 timestamp (returned as a string) when the stage session ended. This is // null if the stage is active. EndTime *time.Time // ID of the session within the stage. SessionId *string // ISO 8601 timestamp (returned as a string) when this stage session began. StartTime *time.Time // contains filtered or unexported fields }
Summary information about a stage session.
type StageSummary ¶
type StageSummary struct { // Stage ARN. // // This member is required. Arn *string // ID of the active session within the stage. ActiveSessionId *string // Stage name. Name *string // Tags attached to the resource. Array of maps, each of the form string:string // (key:value) . See Tagging AWS Resources (https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html) // 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. Tags map[string]string // contains filtered or unexported fields }
Summary information about a stage.
type ValidationException ¶
type ValidationException struct { Message *string ErrorCodeOverride *string ExceptionMessage *string // contains filtered or unexported fields }
func (*ValidationException) Error ¶
func (e *ValidationException) Error() string
func (*ValidationException) ErrorCode ¶
func (e *ValidationException) ErrorCode() string
func (*ValidationException) ErrorFault ¶
func (e *ValidationException) ErrorFault() smithy.ErrorFault
func (*ValidationException) ErrorMessage ¶
func (e *ValidationException) ErrorMessage() string