Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1430234217.2 KB

Create a channel group to group your channels and origin endpoints. A channel group is the top-level resource that consists of channels and origin endpoints that are associated with it and that provides predictable URLs for stream delivery. All channels and origin endpoints within the channel group are guaranteed to share the DNS. You can create only one channel group with each request.

post/channelGroup

Headers

x-amzn-client-tokenstring

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

Request body

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. You can't use spaces in the name. You can't change the name after you create the channel group.

Descriptionstring

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

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

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.

Arnstring required

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

EgressDomainstring required

The output domain where the source stream should be sent. Integrate the egress domain with a downstream CDN (such as Amazon CloudFront) or playback device.

CreatedAtstring date-time required

The date and time the channel group was created.

ModifiedAtstring date-time required

The date and time the channel group was modified.

ETagstring

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

Descriptionstring

The description for your channel group.

Tagsobject

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