AWS Elemental MediaPackage
Live API Reference

Channels id

URI

/channels/id

HTTP Methods

GET

Operation ID: DescribeChannel

Provides details about a channel.

Path Parameters

Name Type Required Description
id String True

Identifier for the object that you are working on.

Responses

Status Code Response Model Description
200 Channel

200 OK response

Channel details are 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.

PUT

Operation ID: UpdateChannel

Updates a specific channel. You can't change the id attribute or any other system-generated attributes.

Path Parameters

Name Type Required Description
id String True

Identifier for the object that you are working on.

Responses

Status Code Response Model Description
200 Channel

200 OK response

The channel is updated 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.

DELETE

Operation ID: DeleteChannel

Permanently deletes a channel.

Path Parameters

Name Type Required Description
id String True

Identifier for the object that you are working on.

Responses

Status Code Response Model Description
202 None

202 Accepted response

AWS Elemental MediaPackage accepted the request but has not processed it yet.

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 PUT

{ "description": "string" }

Response Bodies

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.

ChannelUpdateParameters

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

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:

DescribeChannel

UpdateChannel

DeleteChannel