Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1430234217.2 KB

Create a channel to start receiving content streams. The channel represents the input to MediaPackage for incoming live content from an encoder such as AWS Elemental MediaLive. The channel receives content, and after packaging it, outputs it through an origin endpoint to downstream devices (such as video players or CDNs) that request the content. You can create only one channel with each request. We recommend that you spread out channels between channel groups, such as putting redundant channels in the same AWS Region in different channel groups.

post/channelGroup/{ChannelGroupName}/channel

Path parameters

ChannelGroupNamestring required

The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.

Headers

x-amzn-client-tokenstring

A unique, case-sensitive token that you provide to ensure the idempotency of the request.

Request body

ChannelNamestring required

The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group. You can't change the name after you create the channel.

InputType'HLS' | 'CMAF'
<p>The input type will be an immutable field which will be used to define whether the channel will allow CMAF ingest or HLS ingest. If unprovided, it will default to HLS to preserve current behavior.</p> <p>The allowed values are:</p> <ul> <li> <p> <code>HLS</code> - The HLS streaming specification (which defines M3U8 manifests and TS segments).</p> </li> <li> <p> <code>CMAF</code> - The DASH-IF CMAF Ingest specification (which defines CMAF segments with optional DASH manifests).</p> </li> </ul>
Descriptionstring

Enter any descriptive text that helps you to identify the channel.

tagsobject
<p>A comma-separated list of tag key:value pairs that you define. For example:</p> <p> <code>"Key1": "Value1",</code> </p> <p> <code>"Key2": "Value2"</code> </p>

Response

Success

Arnstring required

The Amazon Resource Name (ARN) associated with the resource.

ChannelNamestring required

The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.

ChannelGroupNamestring required

The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.

CreatedAtstring date-time required

The date and time the channel was created.

ModifiedAtstring date-time required

The date and time the channel was modified.

Descriptionstring

The description for your channel.

InputType'HLS' | 'CMAF'
<p>The input type will be an immutable field which will be used to define whether the channel will allow CMAF ingest or HLS ingest. If unprovided, it will default to HLS to preserve current behavior.</p> <p>The allowed values are:</p> <ul> <li> <p> <code>HLS</code> - The HLS streaming specification (which defines M3U8 manifests and TS segments).</p> </li> <li> <p> <code>CMAF</code> - The DASH-IF CMAF Ingest specification (which defines CMAF segments with optional DASH manifests).</p> </li> </ul>
ETagstring

The current Entity Tag (ETag) associated with this resource. The entity tag can be used to safely make concurrent updates to the resource.

Tagsobject

The comma-separated list of tag key:value pairs assigned to the channel.