ChannelSummary
Summary information about a channel.
Contents
- arn
-
Channel ARN.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 128.
Pattern:
arn:aws:ivs:[a-z0-9-]+:[0-9]+:channel/[a-zA-Z0-9-]+
Required: No
-
Whether the channel is private (enabled for playback authorization). Default:
false
.Type: Boolean
Required: No
- insecureIngest
-
Whether the channel allows insecure RTMP ingest. Default:
false
.Type: Boolean
Required: No
- latencyMode
-
Channel latency mode. Use
NORMAL
to broadcast and deliver live video up to Full HD. UseLOW
for near-real-time interaction with viewers. Default:LOW
.Type: String
Valid Values:
NORMAL | LOW
Required: No
- name
-
Channel name.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 128.
Pattern:
[a-zA-Z0-9-_]*
Required: No
- playbackRestrictionPolicyArn
-
Playback-restriction-policy ARN. A valid ARN value here both specifies the ARN and enables playback restriction. Default: "" (empty string, no playback restriction policy is applied).
Type: String
Length Constraints: Minimum length of 0. Maximum length of 128.
Pattern:
^$|^arn:aws:ivs:[a-z0-9-]+:[0-9]+:playback-restriction-policy/[a-zA-Z0-9-]+$
Required: No
- preset
-
Optional transcode preset for the channel. This is selectable only for
ADVANCED_HD
andADVANCED_SD
channel types. For those channel types, the defaultpreset
isHIGHER_BANDWIDTH_DELIVERY
. For other channel types (BASIC
andSTANDARD
),preset
is the empty string (""
).Type: String
Valid Values:
HIGHER_BANDWIDTH_DELIVERY | CONSTRAINED_BANDWIDTH_DELIVERY
Required: No
- recordingConfigurationArn
-
Recording-configuration ARN. A valid ARN value here both specifies the ARN and enables recording. Default: "" (empty string, recording is disabled).
Type: String
Length Constraints: Minimum length of 0. Maximum length of 128.
Pattern:
^$|^arn:aws:ivs:[a-z0-9-]+:[0-9]+:recording-configuration/[a-zA-Z0-9-]+$
Required: No
-
Tags attached to the resource. Array of 1-50 maps, each of the form
string:string (key:value)
. See Best practices and strategies in Tagging AWS Resources and Tag Editor for details, including restrictions that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no service-specific constraints beyond what is documented there.Type: String to string map
Map Entries: Minimum number of 0 items. Maximum number of 50 items.
Key Length Constraints: Minimum length of 1. Maximum length of 128.
Value Length Constraints: Minimum length of 0. Maximum length of 256.
Required: No
- type
-
Channel type, which determines the allowable resolution and bitrate. If you exceed the allowable input resolution or bitrate, the stream probably will disconnect immediately. Default:
STANDARD
. For details, see Channel Types.Type: String
Valid Values:
BASIC | STANDARD | ADVANCED_SD | ADVANCED_HD
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: