v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1430234217.2 KB

Update the specified origin endpoint. Edit the packaging preferences on an endpoint to optimize the viewing experience. You can't edit the name of the endpoint.

Any edits you make that impact the video output may not be reflected for a few minutes.

put/channelGroup/{ChannelGroupName}/channel/{ChannelName}/originEndpoint/{OriginEndpointName}

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.

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.

Headers

x-amzn-update-if-matchstring

The expected current Entity Tag (ETag) for the resource. If the specified ETag does not match the resource's current entity tag, the update request will be rejected.

Request body

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

The type of container attached 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.

Descriptionstring

Any descriptive information that you want to add to the origin endpoint for future identification purposes.

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 in the update request, the current value is preserved.

Response

Success

Arnstring required

The 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 of 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.

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.