Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1430234217.2 KB

The endpoint is attached to a channel, and represents the output of the live content. You can associate multiple endpoints to a single channel. Each endpoint gives players and downstream CDNs (such as Amazon CloudFront) access to the content for playback. Content can't be served from a channel until it has an endpoint. You can create only one endpoint with each request.

post/channelGroup/{ChannelGroupName}/channel/{ChannelName}/originEndpoint

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.

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.

Headers

x-amzn-client-tokenstring

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

Request body

OriginEndpointNamestring required

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

ContainerType'TS' | 'CMAF' | 'ISM' required

The type of container to attach to this origin endpoint. A container type is a file format that encapsulates one or more media streams, such as audio and video, into a single file. You can't change the container type after you create the endpoint.

Descriptionstring

Enter any descriptive text that helps you to identify the origin endpoint.

StartoverWindowSecondsinteger

The size of the window (in seconds) to create a window of the live stream that's available for on-demand viewing. Viewers can start-over or catch-up on content that falls within the window. The maximum startover window is 1,209,600 seconds (14 days).

UriSeparator'UNDERSCORE' | 'HYPHEN'

The separator character to use in generated URIs for this origin endpoint. This setting applies to all manifest types on the endpoint. If you don't specify a value, the default is <code>UNDERSCORE</code>.

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.

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.

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.

OriginEndpointNamestring required

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

ContainerType'TS' | 'CMAF' | 'ISM' required

The type of container attached to this origin endpoint.

CreatedAtstring date-time required

The date and time the origin endpoint was created.

ModifiedAtstring date-time required

The date and time the origin endpoint was modified.

Descriptionstring

The description for your origin endpoint.

StartoverWindowSecondsinteger

The size of the window (in seconds) to create a window of the live stream that's available for on-demand viewing. Viewers can start-over or catch-up on content that falls within the window.

UriSeparator'UNDERSCORE' | 'HYPHEN'

The separator character used in generated URIs for this origin endpoint.

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 origin endpoint.