MediaLive / Client / create_multiplex_program

create_multiplex_program#

MediaLive.Client.create_multiplex_program(**kwargs)#

Create a new program in the multiplex.

See also: AWS API Documentation

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,
            'AribCaptionsPid': 123,
            'DvbTeletextPids': [
                123,
            ],
            'EcmPid': 123,
            'Smpte2038Pid': 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

        • AribCaptionsPid (integer) – Placeholder documentation for __integer

        • DvbTeletextPids (list) – Placeholder documentation for __listOf__integer

          • (integer) – Placeholder documentation for __integer

        • EcmPid (integer) – Placeholder documentation for __integer

        • Smpte2038Pid (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