Channels - AWS Elemental MediaPackage

Channels

URI

/channels

HTTP methods

GET

Operation ID: ListChannels

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

Query parameters
NameTypeRequiredDescription
nextTokenStringFalse

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

maxResultsStringFalse

Upper bound on number of records to return.

Responses
Status codeResponse modelDescription
200ChannelList

200 OK response

The list of channels is returned successfully.

403None

403 Forbidden response

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

404None

404 Not Found response

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

422None

422 Unprocessable Entity response

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

429None

429 Too Many Requests response

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

500None

500 Internal Server Error response

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

503None

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.

Responses
Status codeResponse modelDescription
200Channel

200 OK response

The channel is created successfully.

403None

403 Forbidden response

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

404None

404 Not Found response

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

422None

422 Unprocessable Entity response

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

429None

429 Too Many Requests response

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

500None

500 Internal Server Error response

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

503None

Service unavailable response

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

OPTIONS

Enable CORS by returning correct headers.

Responses
Status codeResponse modelDescription
200None

Default response for CORS method.

Schemas

Request bodies

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

Response bodies

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

Properties

Channel

Channel configuration.

PropertyTypeRequiredDescription
arn

string

False

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

createdAt

string

False

The date and time the Channel was created.

description

string

False

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

egressAccessLogs

EgressAccessLogs

False

Configures egress access logs.

hlsIngest

HlsIngest

False

System-generated information about the channel.

id

string

False

Unique identifier that you assign to the channel.

ingressAccessLogs

IngressAccessLogs

False

Configures ingress access logs.

tags

Tags

False

The tags assigned to the channel.

ChannelCreateParameters

Channel configuration.

PropertyTypeRequiredDescription
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. Supported characters are numbers, letters, underscores (_), and dashes (-) with a length of 1 to 256 characters.

tags

Tags

False

The tags to assign to the channel.

ChannelList

A collection of Channel records.

PropertyTypeRequiredDescription
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.

EgressAccessLogs

Egress access log configuration parameters.

PropertyTypeRequiredDescription
logGroupName

string

False

Sets a custom AWS CloudWatch log group name for egress logs. If a log group name isn't specified, the default name is used: /aws/MediaPackage/EgressAccessLogs.

HlsIngest

HLS ingest configuration.

PropertyTypeRequiredDescription
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.

PropertyTypeRequiredDescription
id

string

False

The system-generated unique identifier for the IngestEndpoint.

password

string

False

The system-generated password for WebDAV input authentication.

url

string

False

The input URL where the source stream should be sent.

username

string

False

The system-generated username for WebDAV input authentication.

IngressAccessLogs

Ingress access log configuration parameters.

PropertyTypeRequiredDescription
logGroupName

string

False

Sets a custom AWS CloudWatch log group name for ingress logs. If a log group name isn't specified, the default name is used: /aws/MediaPackage/IngressAccessLogs.

Tags

A collection of tags associated with a resource.

Value description:

  • 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" }
PropertyTypeRequiredDescription

*

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