Channel - AWS Elemental MediaTailor

Channel

Creates, describes, updates, or deletes a channel. For information about MediaTailor channels, see Working with channels in the MediaTailor User Guide.

URI

/v1/channel/channelName

HTTP methods

GET

Operation ID: DescribeChannel

Describes the properties of a specific channel.

Path parameters
Name Type Required Description
channelName String True

The identifier for the channel you are working on.

Responses
Status code Response model Description
200 DescribeChannelResponse

Success.

POST

Operation ID: CreateChannel

Creates a channel.

Path parameters
Name Type Required Description
channelName String True

The identifier for the channel you are working on.

Responses
Status code Response model Description
200 DescribeChannelResponse

Success.

PUT

Operation ID: UpdateChannel

Updates an existing channel.

Path parameters
Name Type Required Description
channelName String True

The identifier for the channel you are working on.

Responses
Status code Response model Description
200 DescribeChannelResponse

Success.

DELETE

Operation ID: DeleteChannel

Deletes a channel. You must stop the channel before it can be deleted.

Path parameters
Name Type Required Description
channelName String True

The identifier for the channel you are working on.

Responses
Status code Response model Description
200 DeleteChannelResponse

Success.

Schemas

Request bodies

{ "Outputs": [ { "ManifestName": "string", "DashPlaylistSettings": { "ManifestWindowSeconds": integer, "SuggestedPresentationDelaySeconds": integer, "MinBufferTimeSeconds": integer, "MinUpdatePeriodSeconds": integer }, "HlsPlaylistSettings": { "ManifestWindowSeconds": integer }, "SourceGroup": "string" } ], "PlaybackMode": enum, "tags": { } }
{ "Outputs": [ { "ManifestName": "string", "DashPlaylistSettings": { "ManifestWindowSeconds": integer, "SuggestedPresentationDelaySeconds": integer, "MinBufferTimeSeconds": integer, "MinUpdatePeriodSeconds": integer }, "HlsPlaylistSettings": { "ManifestWindowSeconds": integer }, "SourceGroup": "string" } ] }

Response bodies

{ "ChannelState": enum, "ChannelName": "string", "Outputs": [ { "ManifestName": "string", "DashPlaylistSettings": { "ManifestWindowSeconds": integer, "SuggestedPresentationDelaySeconds": integer, "MinBufferTimeSeconds": integer, "MinUpdatePeriodSeconds": integer }, "PlaybackUrl": "string", "HlsPlaylistSettings": { "ManifestWindowSeconds": integer }, "SourceGroup": "string" } ], "CreationTime": integer, "LastModifiedTime": integer, "Arn": "string", "PlaybackMode": "string", "tags": { } }
{ }

Properties

CreateChannelRequest

The configuration for this channel.

Property Type Required Description
Outputs

Array of type RequestOutputItem

True

The channel's output properties.

PlaybackMode

string

Values: LOOP

True

The type of playback mode for this channel. The only supported value is LOOP.

tags

object

False

The tags to assign to the channel.

DashPlaylistSettings

Dash manifest configuration parameters.

Property Type Required Description
ManifestWindowSeconds

integer

False

The total duration (in seconds) of each manifest. Minimum value: 30 seconds. Maximum value: 3600 seconds.

SuggestedPresentationDelaySeconds

integer

False

Amount of time (in seconds) that the player should be from the live point at the end of the manifest. Minimum value: 2 seconds. Maximum value: 60 seconds.

MinBufferTimeSeconds

integer

False

Minimum amount of content (measured in seconds) that a player must keep available in the buffer. Minimum value: 2 seconds. Maximum value: 60 seconds.

MinUpdatePeriodSeconds

integer

False

Minimum amount of time (in seconds) that the player should wait before requesting updates to the manifest. Minimum value: 2 seconds. Maximum value: 60 seconds.

DeleteChannelResponse

This response includes only the "type" : "object" property.

DescribeChannelResponse

Returns a channel's properties.

Property Type Required Description
ChannelState

string

Values: RUNNING | STOPPED

True

Indicates whether the channel is in a running state or not.

ChannelName

string

True

The name of the channel.

Outputs

Array of type ResponseOutputItem

True

The channel's output properties.

CreationTime

integer

Format: date-time

False

The timestamp of when the channel was created.

LastModifiedTime

integer

Format: date-time

False

The timestamp of when the channel was last modified.

Arn

string

True

The ARN of the channel.

PlaybackMode

string

True

The type of playback for this channel. The only supported value is LOOP.

tags

object

False

The tags assigned to the channel.

HlsPlaylistSettings

HLS playlist configuration parameters.

Property Type Required Description
ManifestWindowSeconds

integer

False

The total duration (in seconds) of each manifest. Minimum value: 30 seconds. Maximum value: 3600 seconds.

RequestOutputItem

The ouput configuration for this channel.

Property Type Required Description
ManifestName

string

True

The name of the manifest for the channel. The name appears in the PlaybackUrl.

DashPlaylistSettings

DashPlaylistSettings

False

DASH manifest configuration parameters.

HlsPlaylistSettings

HlsPlaylistSettings

False

HLS playlist configuration parameters.

SourceGroup

string

True

A string used to match which HttpPackageConfiguration is used for each VodSource.

ResponseOutputItem

This response includes only the "property" : "type" property.

Property Type Required Description
ManifestName

string

True

The name of the manifest for the channel that will appear in the channel output's playback URL.

DashPlaylistSettings

DashPlaylistSettings

False

DASH manifest configuration settings.

PlaybackUrl

string

True

The URL used for playback by content players.

HlsPlaylistSettings

HlsPlaylistSettings

False

HLS manifest configuration settings.

SourceGroup

string

True

A string used to associate a package configuration source group with a channel output.

UpdateChannelRequest

Updates a channel's Outputs.

Property Type Required Description
Outputs

Array of type RequestOutputItem

True

The channel's output properties.

See also

For more information about using this API in one of the language-specific AWS SDKs and references, see the following:

DescribeChannel

CreateChannel

UpdateChannel

DeleteChannel