AWS Elemental MediaPackage
Live API Reference

Channels

URI

/channels

HTTP Methods

GET

Operation ID: ListChannels

Lists channels that match a set of filters that you define.

AWS CLI Request Syntax

aws mediapackage list-channels [--starting-token <value>] [--page-size <value>] [--max-items <value>]

Use pagination to limit the number of entries you receive in the response. For more how to use pagination, see Using the AWS Command Line Interface's Pagination Options.

Query Parameters

Name Type Required Description
nextToken String False

Pagination token from the GET list request. Use the token to fetch the next page of results.

maxResults String False

Upper bound on number of records to return.

Responses

Status Code Response Model Description
200 ChannelList

200 OK response

The list of channels is returned successfully.

403 None

403 Forbidden response

AWS Elemental MediaPackage cannot authorize the request, possibly due to insufficient authentication credentials.

404 None

404 Not Found response

AWS Elemental MediaPackage did not find a representation of the target resource.

422 None

422 Unprocessable Entity response

AWS Elemental MediaPackage could not process the instructions in the body of the request.

429 None

429 Too Many Requests response

Too many requests have been sent in a given amount of time.

500 None

500 Internal Server Error response

An unexpected condition prevented AWS Elemental MediaPackage from fulfilling the request.

503 None

Service unavailable response

AWS Elemental MediaPackage can't currently complete the request, usually because of a temporary overload or maintenance.

POST

Operation ID: CreateChannel

Creates a channel to receive content.

Once created, a channel provides static input URLs. These URLs remain the same throughout the lifetime of the channel, regardless of any failures or upgrades that might occur. Use these URLs to configure the outputs of your upstream encoder.

AWS CLI Request Syntax

aws mediapackage create-channel -id <value> [--description <value>]

For a complete list of channel attributes, see the ChannelCreateParameters property.

Example POST Channel Request Body

{ "id": "sportschannel", "description": "24x7 sports" }

Responses

Status Code Response Model Description
200 Channel

200 OK response

The channel is created successfully.

403 None

403 Forbidden response

AWS Elemental MediaPackage cannot authorize the request, possibly due to insufficient authentication credentials.

404 None

404 Not Found response

AWS Elemental MediaPackage did not find a representation of the target resource.

422 None

422 Unprocessable Entity response

AWS Elemental MediaPackage could not process the instructions in the body of the request.

429 None

429 Too Many Requests response

Too many requests have been sent in a given amount of time.

500 None

500 Internal Server Error response

An unexpected condition prevented AWS Elemental MediaPackage from fulfilling the request.

503 None

Service unavailable response

AWS Elemental MediaPackage can't currently complete the request, usually because of a temporary overload or maintenance.

Schemas

Request Bodies

Example POST

{ "description": "string", "id": "string", "tags": { } }

Response Bodies

Example ChannelList

{ "channels": [ { "description": "string", "hlsIngest": { "ingestEndpoints": [ { "password": "string", "id": "string", "url": "string", "username": "string" } ] }, "id": "string", "arn": "string", "tags": { } } ], "nextToken": "string" }

Example Channel

{ "description": "string", "hlsIngest": { "ingestEndpoints": [ { "password": "string", "id": "string", "url": "string", "username": "string" } ] }, "id": "string", "arn": "string", "tags": { } }

Properties

Channel

Channel configuration.

Property Type Required Description
description

string

False

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

hlsIngest

HlsIngest

False

System-generated information about the channel.

id

string

False

Unique identifier that you assign to the channel.

arn

string

False

The channel's unique system-generated resource name, based on the AWS record.

tags

Tags

False

The tags assigned to the channel.

ChannelCreateParameters

Channel configuration.

Property Type Required Description
description

string

False

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

id

string

True

Unique identifier that you assign to the channel.

tags

Tags

False

The tags to assign to the channel.

ChannelList

Property Type Required Description
channels

Array of type Channel

False

List of channel objects that are configured on this account.

nextToken

string

False

Pagination token. Use this token to request the next page of channel results.

HlsIngest

HLS ingest configuration.

Property Type Required Description
ingestEndpoints

Array of type IngestEndpoint

False

The input URL where the source stream should be sent.

IngestEndpoint

An endpoint for ingesting source content for a channel.

Property Type Required Description
password

string

False

The system-generated password for WebDAV input authentication.

id

string

False

The system-generated unique identifier for the IngestEndpoint.

url

string

False

The input URL where the source stream should be sent.

username

string

False

The system-generated username for WebDAV input authentication.

Tags

A collection of tags associated with a resource.

  • Property: "key1": "value1"

  • Type: string

  • Required: True

  • Description: A comma-separated list of tag key:value pairs that you define. For example:

    { "Key1": "Value1", "Key2": "Value2" }
Property Type Required Description

*

string

False

See Also

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

ListChannels

CreateChannel