Multiplexes - AWS Elemental MediaLive API Reference

Multiplexes

URI

/prod/multiplexes

HTTP Methods

GET

Operation ID: ListMultiplexes

Query Parameters
Name Type Required Description
nextToken String False
maxResults String False
Responses
Status Code Response Model Description
200 ListMultiplexesResultModel

200 response

400 InvalidRequest

400 response

403 AccessDenied

403 response

429 LimitExceeded

429 response

500 InternalServiceError

500 response

502 BadGatewayException

502 response

504 GatewayTimeoutException

504 response

POST

Operation ID: CreateMultiplex

Responses
Status Code Response Model Description
201 CreateMultiplexResultModel

201 response

400 InvalidRequest

400 response

403 AccessDenied

403 response

409 ResourceConflict

409 response

422 MultiplexConfigurationValidationError

422 response

429 LimitExceeded

429 response

500 InternalServiceError

500 response

502 BadGatewayException

502 response

504 GatewayTimeoutException

504 response

Schemas

Request Bodies

Example POST

{ "requestId": "string", "name": "string", "availabilityZones": [ "string" ], "multiplexSettings": { "transportStreamId": integer, "transportStreamBitrate": integer, "transportStreamReservedBitrate": integer, "maximumVideoBufferDelayMilliseconds": integer }, "tags": { } }

Response Bodies

Example ListMultiplexesResultModel

{ "multiplexes": [ { "name": "string", "id": "string", "arn": "string", "availabilityZones": [ "string" ], "state": enum, "pipelinesRunningCount": integer, "tags": { }, "programCount": integer, "multiplexSettings": { "transportStreamBitrate": integer } } ], "nextToken": "string" }

Example CreateMultiplexResultModel

{ "multiplex": { "name": "string", "id": "string", "arn": "string", "availabilityZones": [ "string" ], "state": enum, "pipelinesRunningCount": integer, "multiplexSettings": { "transportStreamId": integer, "transportStreamBitrate": integer, "transportStreamReservedBitrate": integer, "maximumVideoBufferDelayMilliseconds": integer }, "tags": { }, "programCount": integer, "destinations": [ { "mediaConnectSettings": { "entitlementArn": "string" } } ] } }

Example InvalidRequest

{ "message": "string" }

Example AccessDenied

{ "message": "string" }

Example ResourceConflict

{ "message": "string" }

Example MultiplexConfigurationValidationError

{ "message": "string", "validationErrors": [ { "errorMessage": "string", "elementPath": "string" } ] }

Example LimitExceeded

{ "message": "string" }

Example InternalServiceError

{ "message": "string" }

Example BadGatewayException

{ "message": "string" }

Example GatewayTimeoutException

{ "message": "string" }

Properties

AccessDenied

Property Type Required Description
message

string

False

BadGatewayException

Property Type Required Description
message

string

False

CreateMultiplex

Property Type Required Description
requestId

string

True

Unique request ID. This prevents retries from creating multiple resources.

name

string

True

Name of multiplex.

availabilityZones

Array of type string

True

A list of availability zones for the multiplex. You must specify exactly two.

multiplexSettings

MultiplexSettings

True

Configuration for a multiplex event.

tags

Tags

False

A collection of key-value pairs.

CreateMultiplexResultModel

Property Type Required Description
multiplex

Multiplex

False

The newly created multiplex.

GatewayTimeoutException

Property Type Required Description
message

string

False

InternalServiceError

Property Type Required Description
message

string

False

InvalidRequest

Property Type Required Description
message

string

False

LimitExceeded

Property Type Required Description
message

string

False

ListMultiplexesResultModel

Property Type Required Description
multiplexes

Array of type MultiplexSummary

False

List of multiplexes.

nextToken

string

False

Token for the next ListMultiplexes request.

Multiplex

The multiplex object.

Property Type Required Description
name

string

False

The name of the multiplex.

id

string

False

The unique id of the multiplex.

arn

string

False

The unique arn of the multiplex.

availabilityZones

Array of type string

False

A list of availability zones for the multiplex.

state

MultiplexState

False

The current state of the multiplex.

pipelinesRunningCount

integer

False

The number of currently healthy pipelines.

multiplexSettings

MultiplexSettings

False

Configuration for a multiplex event.

tags

Tags

False

A collection of key-value pairs.

programCount

integer

False

The number of programs in the multiplex.

destinations

Array of type MultiplexOutputDestination

False

A list of the multiplex output destinations.

MultiplexConfigurationValidationError

Property Type Required Description
message

string

False

The error message.

validationErrors

Array of type ValidationError

False

A collection of validation error responses.

MultiplexMediaConnectOutputDestinationSettings

Multiplex MediaConnect output destination settings.

Property Type Required Description
entitlementArn

string

MinLength: 1

False

The MediaConnect entitlement ARN available as a Flow source.

MultiplexOutputDestination

Multiplex output destination settings

Property Type Required Description
mediaConnectSettings

MultiplexMediaConnectOutputDestinationSettings

False

Multiplex MediaConnect output destination settings.

MultiplexSettings

Contains configuration for a Multiplex event

Property Type Required Description
transportStreamId

integer

Minimum: 0

Maximum: 65535

True

Transport stream ID.

transportStreamBitrate

integer

Minimum: 1000000

Maximum: 100000000

True

Transport stream bit rate.

transportStreamReservedBitrate

integer

Minimum: 0

Maximum: 100000000

False

Transport stream reserved bit rate.

maximumVideoBufferDelayMilliseconds

integer

Minimum: 800

Maximum: 3000

False

Maximum video buffer delay in milliseconds.

MultiplexSettingsSummary

Contains summary configuration for a Multiplex event.

Property Type Required Description
transportStreamBitrate

integer

Minimum: 1000000

Maximum: 100000000

False

Transport stream bit rate.

MultiplexState

The current state of the multiplex.

  • CREATING

  • CREATE_FAILED

  • IDLE

  • STARTING

  • RUNNING

  • RECOVERING

  • STOPPING

  • DELETING

  • DELETED

MultiplexSummary

Property Type Required Description
name

string

False

The name of the multiplex.

id

string

False

The unique id of the multiplex.

arn

string

False

The unique arn of the multiplex.

availabilityZones

Array of type string

False

A list of availability zones for the multiplex.

state

MultiplexState

False

The current state of the multiplex.

pipelinesRunningCount

integer

False

The number of currently healthy pipelines.

tags

Tags

False

A collection of key-value pairs.

programCount

integer

False

The number of programs in the multiplex.

multiplexSettings

MultiplexSettingsSummary

False

Configuration for a multiplex event.

ResourceConflict

Property Type Required Description
message

string

False

Tags

Property Type Required Description

*

string

False

ValidationError

Property Type Required Description
errorMessage

string

False

The error message.

elementPath

string

False

Path to the source of the error.

See Also

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

ListMultiplexes

CreateMultiplex