URI HTTP methods Schemas Properties See also

Multiplex: list programs

URI

/prod/multiplexes/multiplexId/programs

HTTP methods

GET

Operation ID: ListMultiplexPrograms

Path parameters
Name	Type	Required	Description
`multiplexId`	String	True

Query parameters
Name	Type	Required	Description
`nextToken`	String	False
`maxResults`	String	False

Responses
Status code	Response model	Description
`200`	`ListMultiplexProgramsResultModel`	200 response
`400`	`InvalidRequest`	400 response
`403`	`AccessDenied`	403 response
`404`	`ResourceNotFound`	404 response
`429`	`LimitExceeded`	429 response
`500`	`InternalServiceError`	500 response
`502`	`BadGatewayException`	502 response
`504`	`GatewayTimeoutException`	504 response

POST

Operation ID: CreateMultiplexProgram

Path parameters
Name	Type	Required	Description
`multiplexId`	String	True

Responses
Status code	Response model	Description
`201`	`CreateMultiplexProgramResultModel`	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


{
  "multiplexProgramSettings": {
    "preferredChannelPipeline": enum,
    "programNumber": integer,
    "serviceDescriptor": {
      "providerName": "string",
      "serviceName": "string"
    },
    "videoSettings": {
      "constantBitrate": integer,
      "statmuxSettings": {
        "maximumBitrate": integer,
        "minimumBitrate": integer,
        "priority": integer
      }
    }
  },
  "programName": "string",
  "requestId": "string"
}

Response bodies


{
  "multiplexPrograms": [
    {
      "channelId": "string",
      "programName": "string"
    }
  ],
  "nextToken": "string"
}


{
  "multiplexProgram": {
    "channelId": "string",
    "multiplexProgramSettings": {
      "preferredChannelPipeline": enum,
      "programNumber": integer,
      "serviceDescriptor": {
        "providerName": "string",
        "serviceName": "string"
      },
      "videoSettings": {
        "constantBitrate": integer,
        "statmuxSettings": {
          "maximumBitrate": integer,
          "minimumBitrate": integer,
          "priority": integer
        }
      }
    },
    "packetIdentifiersMap": {
      "audioPids": [
        integer
      ],
      "dvbSubPids": [
        integer
      ],
      "dvbTeletextPid": integer,
      "etvPlatformPid": integer,
      "etvSignalPid": integer,
      "klvDataPids": [
        integer
      ],
      "pcrPid": integer,
      "pmtPid": integer,
      "privateMetadataPid": integer,
      "scte27Pids": [
        integer
      ],
      "scte35Pid": integer,
      "timedMetadataPid": integer,
      "videoPid": integer
    },
    "pipelineDetails": [
      {
        "activeChannelPipeline": "string",
        "pipelineId": "string"
      }
    ],
    "programName": "string"
  }
}


{
  "message": "string"
}


{
  "message": "string"
}


{
  "message": "string"
}


{
  "message": "string"
}


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


{
  "message": "string"
}


{
  "message": "string"
}


{
  "message": "string"
}


{
  "message": "string"
}

Properties

AccessDenied

Property	Type	Required	Description
`message`	string	False

BadGatewayException

Property	Type	Required	Description
`message`	string	False

CreateMultiplexProgram

Property	Type	Required	Description
`multiplexProgramSettings`	MultiplexProgramSettings	True	The settings for this multiplex program.
`programName`	string	True	Name of multiplex program.
`requestId`	string	True	Unique request ID. This prevents retries from creating multiple resources.

CreateMultiplexProgramResultModel

Property	Type	Required	Description
`multiplexProgram`	MultiplexProgram	False	The newly created multiplex program.

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

ListMultiplexProgramsResultModel

Property	Type	Required	Description
`multiplexPrograms`	Array of type MultiplexProgramSummary	False	List of multiplex programs.
`nextToken`	string	False	Token for the next ListMultiplexProgram request.

MultiplexConfigurationValidationError

Property	Type	Required	Description
`message`	string	False	The error message.
`validationErrors`	Array of type ValidationError	False	A collection of validation error responses.

MultiplexProgram

The multiplex program object.

Property	Type	Required	Description
`channelId`	string	False	The MediaLive channel associated with the program.
`multiplexProgramSettings`	MultiplexProgramSettings	False	The settings for this multiplex program.
`packetIdentifiersMap`	MultiplexProgramPacketIdentifiersMap	False	The packet identifier map for this multiplex program.
`pipelineDetails`	Array of type MultiplexProgramPipelineDetail	False	Contains information about the current sources for the specified program in the specified multiplex. Keep in mind that each multiplex pipeline connects to both pipelines in a given source channel (the channel identified by the program). But only one of those channel pipelines is ever active at one time.
`programName`	string	False	The name of the multiplex program.

MultiplexProgramPacketIdentifiersMap

Packet identifiers map for a given Multiplex program.

Property	Type	Required
`audioPids`	Array of type integer	False
`dvbSubPids`	Array of type integer	False
`dvbTeletextPid`	integer	False
`etvPlatformPid`	integer	False
`etvSignalPid`	integer	False
`klvDataPids`	Array of type integer	False
`pcrPid`	integer	False
`pmtPid`	integer	False
`privateMetadataPid`	integer	False
`scte27Pids`	Array of type integer	False
`scte35Pid`	integer	False
`timedMetadataPid`	integer	False
`videoPid`	integer	False

MultiplexProgramPipelineDetail

The current source for one of the pipelines in the multiplex.

Property	Type	Required	Description
`activeChannelPipeline`	string	False	Identifies the channel pipeline that is currently active for the pipeline (identified by PipelineId) in the multiplex.
`pipelineId`	string	False	Identifies a specific pipeline in the multiplex.

MultiplexProgramServiceDescriptor

Transport stream service descriptor configuration for the Multiplex program.

Property Type Required Description

Property	Type	Required	Description
`providerName`	string MaxLength: 256	True	Name of the provider.
`serviceName`	string MaxLength: 256	True	Name of the service.

providerName

string

MaxLength: 256

True

Name of the provider.

serviceName

string

MaxLength: 256

True

Name of the service.

MultiplexProgramSettings

Multiplex Program settings configuration.

Property	Type	Required	Description
`preferredChannelPipeline`	PreferredChannelPipeline	False	Indicates which pipeline is preferred by the multiplex for program ingest.
`programNumber`	integer Minimum: 0 Maximum: 65535	True	Unique program number.
`serviceDescriptor`	MultiplexProgramServiceDescriptor	False	Transport stream service descriptor configuration for the Multiplex program.
`videoSettings`	MultiplexVideoSettings	False	Program video settings configuration.

MultiplexProgramSummary

Property	Type	Required	Description
`channelId`	string	False	The MediaLive Channel associated with the program.
`programName`	string	False	The name of the multiplex program.

MultiplexStatmuxVideoSettings

Statmux rate control settings

Property Type Required Description

Property	Type	Required	Description
`maximumBitrate`	integer Minimum: 100000 Maximum: 100000000	False	Maximum statmux bitrate.
`minimumBitrate`	integer Minimum: 100000 Maximum: 100000000	False	Minimum statmux bitrate.
`priority`	integer Minimum: -5 Maximum: 5	False	The purpose of the priority is to use a combination of the\nmultiplex rate control algorithm and the QVBR capability of the\nencoder to prioritize the video quality of some channels in a\nmultiplex over others. Channels that have a higher priority will\nget higher video quality at the expense of the video quality of\nother channels in the multiplex with lower priority.

maximumBitrate

integer

Minimum: 100000

Maximum: 100000000

False

Maximum statmux bitrate.

minimumBitrate

integer

Minimum: 100000

Maximum: 100000000

False

Minimum statmux bitrate.

priority

integer

Minimum: -5

Maximum: 5

False

The purpose of the priority is to use a combination of the\nmultiplex rate control algorithm and the QVBR capability of the\nencoder to prioritize the video quality of some channels in a\nmultiplex over others. Channels that have a higher priority will\nget higher video quality at the expense of the video quality of\nother channels in the multiplex with lower priority.

MultiplexVideoSettings

The video configuration for each program in a multiplex.

Property Type Required Description

Property	Type	Required	Description
`constantBitrate`	integer Minimum: 100000 Maximum: 100000000	False	The constant bitrate configuration for the video encode. When this field is defined, StatmuxSettings must be undefined.
`statmuxSettings`	MultiplexStatmuxVideoSettings	False	Statmux rate control settings. When this field is defined, ConstantBitrate must be undefined.

constantBitrate

integer

Minimum: 100000

Maximum: 100000000

False

The constant bitrate configuration for the video encode. When this field is defined, StatmuxSettings must be undefined.

statmuxSettings

MultiplexStatmuxVideoSettings

False

Statmux rate control settings. When this field is defined, ConstantBitrate must be undefined.

PreferredChannelPipeline

Indicates which pipeline is preferred by the multiplex for program ingest. If set to \"PIPELINE_0\" or \"PIPELINE_1\" and an unhealthy ingest causes the multiplex to switch to the non-preferred pipeline, it will switch back once that ingest is healthy again. If set to \"CURRENTLY_ACTIVE\", it will not switch back to the other pipeline based on it recovering to a healthy state, it will only switch if the active pipeline becomes unhealthy.

CURRENTLY_ACTIVE
PIPELINE_0
PIPELINE_1

ResourceConflict

Property	Type	Required	Description
`message`	string	False

ResourceNotFound

Property	Type	Required	Description
`message`	string	False

ValidationError

Property	Type	Required	Description
`elementPath`	string	False	Path to the source of the error.
`errorMessage`	string	False	The error message.