MediaLive / Client / create_multiplex_program

create_multiplex_program#

MediaLive.Client.create_multiplex_program(**kwargs)#

Create a new program in the multiplex.

Request Syntax

response = client.create_multiplex_program(
    MultiplexId='string',
    MultiplexProgramSettings={
        'PreferredChannelPipeline': 'CURRENTLY_ACTIVE'|'PIPELINE_0'|'PIPELINE_1',
        'ProgramNumber': 123,
        'ServiceDescriptor': {
            'ProviderName': 'string',
            'ServiceName': 'string'
        },
        'VideoSettings': {
            'ConstantBitrate': 123,
            'StatmuxSettings': {
                'MaximumBitrate': 123,
                'MinimumBitrate': 123,
                'Priority': 123
            }
        }
    },
    ProgramName='string',
    RequestId='string'
)

Parameters:

MultiplexId (string) – [REQUIRED] ID of the multiplex where the program is to be created.
MultiplexProgramSettings (dict) –
[REQUIRED] The settings for this multiplex program.
- PreferredChannelPipeline (string) – Indicates which pipeline is preferred by the multiplex for program ingest.
- ProgramNumber (integer) – [REQUIRED] Unique program number.
- ServiceDescriptor (dict) – Transport stream service descriptor configuration for the Multiplex program.
  - ProviderName (string) – [REQUIRED] Name of the provider.
  - ServiceName (string) – [REQUIRED] Name of the service.
- VideoSettings (dict) – Program video settings configuration.
  - ConstantBitrate (integer) – The constant bitrate configuration for the video encode. When this field is defined, StatmuxSettings must be undefined.
  - StatmuxSettings (dict) – Statmux rate control settings. When this field is defined, ConstantBitrate must be undefined.
    - MaximumBitrate (integer) – Maximum statmux bitrate.
    - MinimumBitrate (integer) – Minimum statmux bitrate.
    - Priority (integer) – The purpose of the priority is to use a combination of thenmultiplex rate control algorithm and the QVBR capability of thenencoder to prioritize the video quality of some channels in anmultiplex over others. Channels that have a higher priority willnget higher video quality at the expense of the video quality ofnother channels in the multiplex with lower priority.
ProgramName (string) – [REQUIRED] Name of multiplex program.
RequestId (string) – [REQUIRED] Unique request ID. This prevents retries from creating multiple resources.This field is autopopulated if not provided.

Return type:

dict

Returns:

Response Syntax

{
    'MultiplexProgram': {
        'ChannelId': 'string',
        'MultiplexProgramSettings': {
            'PreferredChannelPipeline': 'CURRENTLY_ACTIVE'|'PIPELINE_0'|'PIPELINE_1',
            'ProgramNumber': 123,
            'ServiceDescriptor': {
                'ProviderName': 'string',
                'ServiceName': 'string'
            },
            'VideoSettings': {
                'ConstantBitrate': 123,
                'StatmuxSettings': {
                    'MaximumBitrate': 123,
                    'MinimumBitrate': 123,
                    'Priority': 123
                }
            }
        },
        'PacketIdentifiersMap': {
            'AudioPids': [
                123,
            ],
            'DvbSubPids': [
                123,
            ],
            'DvbTeletextPid': 123,
            'EtvPlatformPid': 123,
            'EtvSignalPid': 123,
            'KlvDataPids': [
                123,
            ],
            'PcrPid': 123,
            'PmtPid': 123,
            'PrivateMetadataPid': 123,
            'Scte27Pids': [
                123,
            ],
            'Scte35Pid': 123,
            'TimedMetadataPid': 123,
            'VideoPid': 123
        },
        'PipelineDetails': [
            {
                'ActiveChannelPipeline': 'string',
                'PipelineId': 'string'
            },
        ],
        'ProgramName': 'string'
    }
}

Response Structure

(dict) – Creation of the program is in progress.
- MultiplexProgram (dict) – The newly created multiplex program.
  - ChannelId (string) – The MediaLive channel associated with the program.
  - MultiplexProgramSettings (dict) – The settings for this multiplex program.
    - PreferredChannelPipeline (string) – Indicates which pipeline is preferred by the multiplex for program ingest.
    - ProgramNumber (integer) – Unique program number.
    - ServiceDescriptor (dict) – Transport stream service descriptor configuration for the Multiplex program.
      - ProviderName (string) – Name of the provider.
      - ServiceName (string) – Name of the service.
    - VideoSettings (dict) – Program video settings configuration.
      - ConstantBitrate (integer) – The constant bitrate configuration for the video encode. When this field is defined, StatmuxSettings must be undefined.
      - StatmuxSettings (dict) – Statmux rate control settings. When this field is defined, ConstantBitrate must be undefined.
        
        MaximumBitrate (integer) – Maximum statmux bitrate.
        
        MinimumBitrate (integer) – Minimum statmux bitrate.
        
        Priority (integer) – The purpose of the priority is to use a combination of thenmultiplex rate control algorithm and the QVBR capability of thenencoder to prioritize the video quality of some channels in anmultiplex over others. Channels that have a higher priority willnget higher video quality at the expense of the video quality ofnother channels in the multiplex with lower priority.
  - PacketIdentifiersMap (dict) – The packet identifier map for this multiplex program.
    - AudioPids (list) – Placeholder documentation for __listOf__integer
      - (integer) – Placeholder documentation for __integer
    - DvbSubPids (list) – Placeholder documentation for __listOf__integer
      - (integer) – Placeholder documentation for __integer
    - DvbTeletextPid (integer) – Placeholder documentation for __integer
    - EtvPlatformPid (integer) – Placeholder documentation for __integer
    - EtvSignalPid (integer) – Placeholder documentation for __integer
    - KlvDataPids (list) – Placeholder documentation for __listOf__integer
      - (integer) – Placeholder documentation for __integer
    - PcrPid (integer) – Placeholder documentation for __integer
    - PmtPid (integer) – Placeholder documentation for __integer
    - PrivateMetadataPid (integer) – Placeholder documentation for __integer
    - Scte27Pids (list) – Placeholder documentation for __listOf__integer
      - (integer) – Placeholder documentation for __integer
    - Scte35Pid (integer) – Placeholder documentation for __integer
    - TimedMetadataPid (integer) – Placeholder documentation for __integer
    - VideoPid (integer) – Placeholder documentation for __integer
  - PipelineDetails (list) – 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.
    - (dict) – The current source for one of the pipelines in the multiplex.
      - ActiveChannelPipeline (string) – Identifies the channel pipeline that is currently active for the pipeline (identified by PipelineId) in the multiplex.
      - PipelineId (string) – Identifies a specific pipeline in the multiplex.
  - ProgramName (string) – The name of the multiplex program.

Exceptions

MediaLive.Client.exceptions.BadRequestException
MediaLive.Client.exceptions.UnprocessableEntityException
MediaLive.Client.exceptions.InternalServerErrorException
MediaLive.Client.exceptions.ForbiddenException
MediaLive.Client.exceptions.BadGatewayException
MediaLive.Client.exceptions.GatewayTimeoutException
MediaLive.Client.exceptions.TooManyRequestsException
MediaLive.Client.exceptions.ConflictException