AWS API Changes

2026/09/09 - AWS Elemental MediaPackage v2 - 4 updated api methods

Changes Dynamic Multiview enables viewers to watch multiple live video streams in a single combined output. Viewers can select from 6 preset tiled layouts. Create MediaPackage channels with Input Type MULTIVIEW and configure Available Layouts and Available Sources. See the API Documentation for details.

CreateChannel (updated)

Link ¶
Changes (request, response)
Request

{'InputType': {'MULTIVIEW'},
 'MultiviewConfiguration': {'AvailableLayouts': ['LAYOUT_2EH | LAYOUT_2PL | '
                                                 'LAYOUT_3EL | LAYOUT_3PL | '
                                                 'LAYOUT_4E | LAYOUT_4PL'],
                            'AvailableSources': ['string']}}

Response

{'AttachedMultiviewChannels': ['string'],
 'InputType': {'MULTIVIEW'},
 'MultiviewConfiguration': {'AvailableLayouts': ['LAYOUT_2EH | LAYOUT_2PL | '
                                                 'LAYOUT_3EL | LAYOUT_3PL | '
                                                 'LAYOUT_4E | LAYOUT_4PL'],
                            'AvailableSources': ['string']}}

Create a channel to start receiving content streams. The channel represents the input to MediaPackage for incoming live content from an encoder such as AWS Elemental MediaLive. The channel receives content, and after packaging it, outputs it through an origin endpoint to downstream devices (such as video players or CDNs) that request the content. You can create only one channel with each request. We recommend that you spread out channels between channel groups, such as putting redundant channels in the same AWS Region in different channel groups.

See also: AWS API Documentation

Request Syntax

client.create_channel(
    ChannelGroupName='string',
    ChannelName='string',
    ClientToken='string',
    InputType='HLS'|'CMAF'|'MULTIVIEW',
    Description='string',
    InputSwitchConfiguration={
        'MQCSInputSwitching': True|False,
        'PreferredInput': 123
    },
    OutputHeaderConfiguration={
        'PublishMQCS': True|False
    },
    MultiviewConfiguration={
        'AvailableSources': [
            'string',
        ],
        'AvailableLayouts': [
            'LAYOUT_2EH'|'LAYOUT_2PL'|'LAYOUT_3EL'|'LAYOUT_3PL'|'LAYOUT_4E'|'LAYOUT_4PL',
        ]
    },
    OutputLockingMode='EPOCH_LOCKED'|'NON_EPOCH_LOCKED',
    Tags={
        'string': 'string'
    }
)

type ChannelGroupName:

string

param ChannelGroupName:

[REQUIRED]

The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.

type ChannelName:

string

param ChannelName:

[REQUIRED]

The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group. You can't change the name after you create the channel.

type ClientToken:

string

param ClientToken:

A unique, case-sensitive token that you provide to ensure the idempotency of the request.

This field is autopopulated if not provided.

type InputType:

string

param InputType:

The input type is an immutable field. It defines whether the channel allows CMAF ingest, HLS ingest, or server-side multiview output. Multiview channels receive no ingest of their own. If unprovided, the value defaults to HLS.

The allowed values are:

HLS - The HLS streaming specification (which defines M3U8 manifests and TS segments).
CMAF - The DASH-IF CMAF Ingest specification (which defines CMAF segments with optional DASH manifests).
MULTIVIEW – Server-side multiview. The channel receives no ingest of its own. Instead, it composites video from the source channels in its MultiviewConfiguration into a single tiled output stream.

type Description:

string

param Description:

Enter any descriptive text that helps you to identify the channel.

type InputSwitchConfiguration:

dict

param InputSwitchConfiguration:

The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when InputType is CMAF.

MQCSInputSwitching (boolean) --

When true, AWS Elemental MediaPackage performs input switching based on the MQCS. Default is false. This setting is valid only when InputType is CMAF.
PreferredInput (integer) --

For CMAF inputs, indicates which input MediaPackage should prefer when both inputs have equal MQCS scores. Select 1 to prefer the first ingest endpoint, or 2 to prefer the second ingest endpoint. If you don't specify a preferred input, MediaPackage uses its default switching behavior when MQCS scores are equal.

type OutputHeaderConfiguration:

dict

param OutputHeaderConfiguration:

The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when InputType is CMAF.

PublishMQCS (boolean) --

When true, AWS Elemental MediaPackage includes the MQCS in responses to the CDN. This setting is valid only when InputType is CMAF.

type MultiviewConfiguration:

dict

param MultiviewConfiguration:

The multiview configuration for the channel. This setting is required when InputType is MULTIVIEW, and can't be set for any other input type.

AvailableSources (list) -- [REQUIRED]

The channels that players can use as tiles in this multiview channel's output. Each source channel must be in the same channel group as the multiview channel, and must have an InputType of CMAF. Only the channels that you list here are available as tiles.
- (string) --
AvailableLayouts (list) -- [REQUIRED]

The tile layouts that players can request from this multiview channel's origin endpoints. Only the layouts that you list here are available. Each layout must appear at most once.
- (string) --
  
  A tile layout for a multiview channel. Each layout determines how many source tiles are composited into the output and how those tiles are arranged.
  
  The allowed values are:
  - LAYOUT_SINGLE – One tile at full resolution. Use this to serve a single source as a standard stream.
  - LAYOUT_2EH – Two tiles of equal size, arranged horizontally.
  - LAYOUT_2PL – Two tiles, with one larger primary tile.
  - LAYOUT_3EB – Three tiles of equal size, with two on top and one below.
  - LAYOUT_3EL – Three tiles of equal size, arranged in two columns.
  - LAYOUT_3PL – Three tiles, with one larger primary tile on the left and two stacked on the right.
  - LAYOUT_4E – Four tiles of equal size, arranged in a two-by-two grid.
  - LAYOUT_4PL – Four tiles, with one larger primary tile on the left and three stacked on the right.

type OutputLockingMode:

string

param OutputLockingMode:

The output locking mode for the channel. This setting is only valid when InputType is CMAF. This value is immutable after channel creation. If you don't specify a value, the default is EPOCH_LOCKED.

The allowed values are:

EPOCH_LOCKED - The channel uses epoch-locked behavior with deterministic sequence numbering and fixed segment boundaries aligned to epoch time. This mode supports cross-region synchronization and failover.
NON_EPOCH_LOCKED - The channel uses non-epoch-locked behavior with duration-based segment combining and monotonically increasing sequence numbers starting from 0. This mode does not support cross-region synchronization or failover.

type Tags:

dict

param Tags:

A comma-separated list of tag key:value pairs that you define. For example:

"Key1": "Value1",

"Key2": "Value2"

(string) --
- (string) --

rtype:

dict

returns:

Response Syntax

{
    'MultiviewConfiguration': {
        'AvailableSources': [
            'string',
        ],
        'AvailableLayouts': [
            'LAYOUT_2EH'|'LAYOUT_2PL'|'LAYOUT_3EL'|'LAYOUT_3PL'|'LAYOUT_4E'|'LAYOUT_4PL',
        ]
    },
    'AttachedMultiviewChannels': [
        'string',
    ],
    'Arn': 'string',
    'ChannelName': 'string',
    'ChannelGroupName': 'string',
    'CreatedAt': datetime(2015, 1, 1),
    'ModifiedAt': datetime(2015, 1, 1),
    'Description': 'string',
    'IngestEndpoints': [
        {
            'Id': 'string',
            'Url': 'string'
        },
    ],
    'InputType': 'HLS'|'CMAF'|'MULTIVIEW',
    'ETag': 'string',
    'Tags': {
        'string': 'string'
    },
    'InputSwitchConfiguration': {
        'MQCSInputSwitching': True|False,
        'PreferredInput': 123
    },
    'OutputHeaderConfiguration': {
        'PublishMQCS': True|False
    },
    'OutputLockingMode': 'EPOCH_LOCKED'|'NON_EPOCH_LOCKED'
}

Response Structure

(dict) --
- MultiviewConfiguration (dict) --
  
  The multiview configuration for the channel. This is present only when InputType is MULTIVIEW.
  - AvailableSources (list) --
    
    The channels that players can use as tiles in this multiview channel's output. Each source channel must be in the same channel group as the multiview channel, and must have an InputType of CMAF. Only the channels that you list here are available as tiles.
    - (string) --
  - AvailableLayouts (list) --
    
    The tile layouts that players can request from this multiview channel's origin endpoints. Only the layouts that you list here are available. Each layout must appear at most once.
    - (string) --
      
      A tile layout for a multiview channel. Each layout determines how many source tiles are composited into the output and how those tiles are arranged.
      
      The allowed values are:
      - LAYOUT_SINGLE – One tile at full resolution. Use this to serve a single source as a standard stream.
      - LAYOUT_2EH – Two tiles of equal size, arranged horizontally.
      - LAYOUT_2PL – Two tiles, with one larger primary tile.
      - LAYOUT_3EB – Three tiles of equal size, with two on top and one below.
      - LAYOUT_3EL – Three tiles of equal size, arranged in two columns.
      - LAYOUT_3PL – Three tiles, with one larger primary tile on the left and two stacked on the right.
      - LAYOUT_4E – Four tiles of equal size, arranged in a two-by-two grid.
      - LAYOUT_4PL – Four tiles, with one larger primary tile on the left and three stacked on the right.
- AttachedMultiviewChannels (list) --
  
  The multiview channels, in the same channel group, that list this channel as an available source. This is a read-only field. You can't delete a channel while any multiview channel still lists it as a source. Use this field to find the multiview channels that you need to update first.
  - (string) --
- Arn (string) --
  
  The Amazon Resource Name (ARN) associated with the resource.
- ChannelName (string) --
  
  The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- ChannelGroupName (string) --
  
  The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- CreatedAt (datetime) --
  
  The date and time the channel was created.
- ModifiedAt (datetime) --
  
  The date and time the channel was modified.
- Description (string) --
  
  The description for your channel.
- IngestEndpoints (list) --
  
  The list of ingest endpoints.
  - (dict) --
    
    The ingest domain URL where the source stream should be sent.
    - Id (string) --
      
      The system-generated unique identifier for the IngestEndpoint.
    - Url (string) --
      
      The ingest domain URL where the source stream should be sent.
- InputType (string) --
  
  The input type is an immutable field. It defines whether the channel allows CMAF ingest, HLS ingest, or server-side multiview output. Multiview channels receive no ingest of their own. If unprovided, the value defaults to HLS.
  
  The allowed values are:
  - HLS - The HLS streaming specification (which defines M3U8 manifests and TS segments).
  - CMAF - The DASH-IF CMAF Ingest specification (which defines CMAF segments with optional DASH manifests).
  - MULTIVIEW – Server-side multiview. The channel receives no ingest of its own. Instead, it composites video from the source channels in its MultiviewConfiguration into a single tiled output stream.
- ETag (string) --
  
  The current Entity Tag (ETag) associated with this resource. The entity tag can be used to safely make concurrent updates to the resource.
- Tags (dict) --
  
  The comma-separated list of tag key:value pairs assigned to the channel.
  - (string) --
    - (string) --
- InputSwitchConfiguration (dict) --
  
  The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when InputType is CMAF.
  - MQCSInputSwitching (boolean) --
    
    When true, AWS Elemental MediaPackage performs input switching based on the MQCS. Default is false. This setting is valid only when InputType is CMAF.
  - PreferredInput (integer) --
    
    For CMAF inputs, indicates which input MediaPackage should prefer when both inputs have equal MQCS scores. Select 1 to prefer the first ingest endpoint, or 2 to prefer the second ingest endpoint. If you don't specify a preferred input, MediaPackage uses its default switching behavior when MQCS scores are equal.
- OutputHeaderConfiguration (dict) --
  
  The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when InputType is CMAF.
  - PublishMQCS (boolean) --
    
    When true, AWS Elemental MediaPackage includes the MQCS in responses to the CDN. This setting is valid only when InputType is CMAF.
- OutputLockingMode (string) --
  
  The output locking mode configured for the channel.
  
  The allowed values are:
  - EPOCH_LOCKED - The channel uses epoch-locked behavior with deterministic sequence numbering and fixed segment boundaries aligned to epoch time.
  - NON_EPOCH_LOCKED - The channel uses non-epoch-locked behavior with duration-based segment combining and monotonically increasing sequence numbers starting from 0.

GetChannel (updated)

Link ¶
Changes (response)

{'AttachedMultiviewChannels': ['string'],
 'InputType': {'MULTIVIEW'},
 'MultiviewConfiguration': {'AvailableLayouts': ['LAYOUT_2EH | LAYOUT_2PL | '
                                                 'LAYOUT_3EL | LAYOUT_3PL | '
                                                 'LAYOUT_4E | LAYOUT_4PL'],
                            'AvailableSources': ['string']}}

Retrieves the specified channel that's configured in AWS Elemental MediaPackage.

See also: AWS API Documentation

Request Syntax

client.get_channel(
    ChannelGroupName='string',
    ChannelName='string'
)

type ChannelGroupName:

string

param ChannelGroupName:

[REQUIRED]

The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.

type ChannelName:

string

param ChannelName:

[REQUIRED]

The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.

rtype:

dict

returns:

Response Syntax

{
    'MultiviewConfiguration': {
        'AvailableSources': [
            'string',
        ],
        'AvailableLayouts': [
            'LAYOUT_2EH'|'LAYOUT_2PL'|'LAYOUT_3EL'|'LAYOUT_3PL'|'LAYOUT_4E'|'LAYOUT_4PL',
        ]
    },
    'AttachedMultiviewChannels': [
        'string',
    ],
    'Arn': 'string',
    'ChannelName': 'string',
    'ChannelGroupName': 'string',
    'CreatedAt': datetime(2015, 1, 1),
    'ModifiedAt': datetime(2015, 1, 1),
    'ResetAt': datetime(2015, 1, 1),
    'Description': 'string',
    'IngestEndpoints': [
        {
            'Id': 'string',
            'Url': 'string'
        },
    ],
    'InputType': 'HLS'|'CMAF'|'MULTIVIEW',
    'ETag': 'string',
    'Tags': {
        'string': 'string'
    },
    'InputSwitchConfiguration': {
        'MQCSInputSwitching': True|False,
        'PreferredInput': 123
    },
    'OutputHeaderConfiguration': {
        'PublishMQCS': True|False
    },
    'OutputLockingMode': 'EPOCH_LOCKED'|'NON_EPOCH_LOCKED'
}

Response Structure

(dict) --
- MultiviewConfiguration (dict) --
  
  The multiview configuration for the channel. This is present only when InputType is MULTIVIEW.
  - AvailableSources (list) --
    
    The channels that players can use as tiles in this multiview channel's output. Each source channel must be in the same channel group as the multiview channel, and must have an InputType of CMAF. Only the channels that you list here are available as tiles.
    - (string) --
  - AvailableLayouts (list) --
    
    The tile layouts that players can request from this multiview channel's origin endpoints. Only the layouts that you list here are available. Each layout must appear at most once.
    - (string) --
      
      A tile layout for a multiview channel. Each layout determines how many source tiles are composited into the output and how those tiles are arranged.
      
      The allowed values are:
      - LAYOUT_SINGLE – One tile at full resolution. Use this to serve a single source as a standard stream.
      - LAYOUT_2EH – Two tiles of equal size, arranged horizontally.
      - LAYOUT_2PL – Two tiles, with one larger primary tile.
      - LAYOUT_3EB – Three tiles of equal size, with two on top and one below.
      - LAYOUT_3EL – Three tiles of equal size, arranged in two columns.
      - LAYOUT_3PL – Three tiles, with one larger primary tile on the left and two stacked on the right.
      - LAYOUT_4E – Four tiles of equal size, arranged in a two-by-two grid.
      - LAYOUT_4PL – Four tiles, with one larger primary tile on the left and three stacked on the right.
- AttachedMultiviewChannels (list) --
  
  The multiview channels, in the same channel group, that list this channel as an available source. This is a read-only field. You can't delete a channel while any multiview channel still lists it as a source. Use this field to find the multiview channels that you need to update first.
  - (string) --
- Arn (string) --
  
  The Amazon Resource Name (ARN) associated with the resource.
- ChannelName (string) --
  
  The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- ChannelGroupName (string) --
  
  The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- CreatedAt (datetime) --
  
  The date and time the channel was created.
- ModifiedAt (datetime) --
  
  The date and time the channel was modified.
- ResetAt (datetime) --
  
  The time that the channel was last reset.
- Description (string) --
  
  The description for your channel.
- IngestEndpoints (list) --
  
  The list of ingest endpoints.
  - (dict) --
    
    The ingest domain URL where the source stream should be sent.
    - Id (string) --
      
      The system-generated unique identifier for the IngestEndpoint.
    - Url (string) --
      
      The ingest domain URL where the source stream should be sent.
- InputType (string) --
  
  The input type is an immutable field. It defines whether the channel allows CMAF ingest, HLS ingest, or server-side multiview output. Multiview channels receive no ingest of their own. If unprovided, the value defaults to HLS.
  
  The allowed values are:
  - HLS - The HLS streaming specification (which defines M3U8 manifests and TS segments).
  - CMAF - The DASH-IF CMAF Ingest specification (which defines CMAF segments with optional DASH manifests).
  - MULTIVIEW – Server-side multiview. The channel receives no ingest of its own. Instead, it composites video from the source channels in its MultiviewConfiguration into a single tiled output stream.
- ETag (string) --
  
  The current Entity Tag (ETag) associated with this resource. The entity tag can be used to safely make concurrent updates to the resource.
- Tags (dict) --
  
  The comma-separated list of tag key:value pairs assigned to the channel.
  - (string) --
    - (string) --
- InputSwitchConfiguration (dict) --
  
  The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when InputType is CMAF.
  - MQCSInputSwitching (boolean) --
    
    When true, AWS Elemental MediaPackage performs input switching based on the MQCS. Default is false. This setting is valid only when InputType is CMAF.
  - PreferredInput (integer) --
    
    For CMAF inputs, indicates which input MediaPackage should prefer when both inputs have equal MQCS scores. Select 1 to prefer the first ingest endpoint, or 2 to prefer the second ingest endpoint. If you don't specify a preferred input, MediaPackage uses its default switching behavior when MQCS scores are equal.
- OutputHeaderConfiguration (dict) --
  
  The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when InputType is CMAF.
  - PublishMQCS (boolean) --
    
    When true, AWS Elemental MediaPackage includes the MQCS in responses to the CDN. This setting is valid only when InputType is CMAF.
- OutputLockingMode (string) --
  
  The output locking mode configured for the channel.
  
  The allowed values are:
  - EPOCH_LOCKED - The channel uses epoch-locked behavior with deterministic sequence numbering and fixed segment boundaries aligned to epoch time.
  - NON_EPOCH_LOCKED - The channel uses non-epoch-locked behavior with duration-based segment combining and monotonically increasing sequence numbers starting from 0.

ListChannels (updated)

Link ¶
Changes (response)

{'Items': {'AttachedMultiviewChannels': ['string'],
           'InputType': {'MULTIVIEW'},
           'MultiviewConfiguration': {'AvailableLayouts': ['LAYOUT_2EH | '
                                                           'LAYOUT_2PL | '
                                                           'LAYOUT_3EL | '
                                                           'LAYOUT_3PL | '
                                                           'LAYOUT_4E | '
                                                           'LAYOUT_4PL'],
                                      'AvailableSources': ['string']}}}

Retrieves all channels in a specific channel group that are configured in AWS Elemental MediaPackage.

See also: AWS API Documentation

Request Syntax

client.list_channels(
    ChannelGroupName='string',
    MaxResults=123,
    NextToken='string'
)

type ChannelGroupName:

string

param ChannelGroupName:

[REQUIRED]

The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.

type MaxResults:

integer

param MaxResults:

The maximum number of results to return in the response.

type NextToken:

string

param NextToken:

The pagination token from the GET list request. Use the token to fetch the next page of results.

rtype:

dict

returns:

Response Syntax

{
    'Items': [
        {
            'Arn': 'string',
            'ChannelName': 'string',
            'ChannelGroupName': 'string',
            'CreatedAt': datetime(2015, 1, 1),
            'ModifiedAt': datetime(2015, 1, 1),
            'Description': 'string',
            'InputType': 'HLS'|'CMAF'|'MULTIVIEW',
            'OutputLockingMode': 'EPOCH_LOCKED'|'NON_EPOCH_LOCKED',
            'MultiviewConfiguration': {
                'AvailableSources': [
                    'string',
                ],
                'AvailableLayouts': [
                    'LAYOUT_2EH'|'LAYOUT_2PL'|'LAYOUT_3EL'|'LAYOUT_3PL'|'LAYOUT_4E'|'LAYOUT_4PL',
                ]
            },
            'AttachedMultiviewChannels': [
                'string',
            ]
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) --
- Items (list) --
  
  The objects being returned.
  - (dict) --
    
    The configuration of the channel.
    - Arn (string) --
      
      The Amazon Resource Name (ARN) associated with the resource.
    - ChannelName (string) --
      
      The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
    - ChannelGroupName (string) --
      
      The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
    - CreatedAt (datetime) --
      
      The date and time the channel was created.
    - ModifiedAt (datetime) --
      
      The date and time the channel was modified.
    - Description (string) --
      
      Any descriptive information that you want to add to the channel for future identification purposes.
    - InputType (string) --
      
      The input type is an immutable field. It defines whether the channel allows CMAF ingest, HLS ingest, or server-side multiview output. Multiview channels receive no ingest of their own. If unprovided, the value defaults to HLS.
      
      The allowed values are:
      - HLS - The HLS streaming specification (which defines M3U8 manifests and TS segments).
      - CMAF - The DASH-IF CMAF Ingest specification (which defines CMAF segments with optional DASH manifests).
      - MULTIVIEW – Server-side multiview. The channel receives no ingest of its own. Instead, it composites video from the source channels in its MultiviewConfiguration into a single tiled output stream.
    - OutputLockingMode (string) --
      
      The output locking mode configured for the channel.
      
      The allowed values are:
      - EPOCH_LOCKED - The channel uses epoch-locked behavior with deterministic sequence numbering and fixed segment boundaries aligned to epoch time.
      - NON_EPOCH_LOCKED - The channel uses non-epoch-locked behavior with duration-based segment combining and monotonically increasing sequence numbers starting from 0.
    - MultiviewConfiguration (dict) --
      
      The multiview configuration for the channel. This is present only when InputType is MULTIVIEW.
      - AvailableSources (list) --
        
        The channels that players can use as tiles in this multiview channel's output. Each source channel must be in the same channel group as the multiview channel, and must have an InputType of CMAF. Only the channels that you list here are available as tiles.
        
        (string) --
      - AvailableLayouts (list) --
        
        The tile layouts that players can request from this multiview channel's origin endpoints. Only the layouts that you list here are available. Each layout must appear at most once.
        
        (string) --
        
        A tile layout for a multiview channel. Each layout determines how many source tiles are composited into the output and how those tiles are arranged.
        
        The allowed values are:
        
        LAYOUT_SINGLE – One tile at full resolution. Use this to serve a single source as a standard stream.
        
        LAYOUT_2EH – Two tiles of equal size, arranged horizontally.
        
        LAYOUT_2PL – Two tiles, with one larger primary tile.
        
        LAYOUT_3EB – Three tiles of equal size, with two on top and one below.
        
        LAYOUT_3EL – Three tiles of equal size, arranged in two columns.
        
        LAYOUT_3PL – Three tiles, with one larger primary tile on the left and two stacked on the right.
        
        LAYOUT_4E – Four tiles of equal size, arranged in a two-by-two grid.
        
        LAYOUT_4PL – Four tiles, with one larger primary tile on the left and three stacked on the right.
    - AttachedMultiviewChannels (list) --
      
      The multiview channels, in the same channel group, that list this channel as an available source. This is a read-only field.
      - (string) --
- NextToken (string) --
  
  The pagination token from the GET list request.

UpdateChannel (updated)

Link ¶
Changes (request, response)
Request

{'MultiviewConfiguration': {'AvailableLayouts': ['LAYOUT_2EH | LAYOUT_2PL | '
                                                 'LAYOUT_3EL | LAYOUT_3PL | '
                                                 'LAYOUT_4E | LAYOUT_4PL'],
                            'AvailableSources': ['string']}}

Response

{'AttachedMultiviewChannels': ['string'],
 'InputType': {'MULTIVIEW'},
 'MultiviewConfiguration': {'AvailableLayouts': ['LAYOUT_2EH | LAYOUT_2PL | '
                                                 'LAYOUT_3EL | LAYOUT_3PL | '
                                                 'LAYOUT_4E | LAYOUT_4PL'],
                            'AvailableSources': ['string']}}

Update the specified channel. You can edit if MediaPackage sends ingest or egress access logs to the CloudWatch log group, if content will be encrypted, the description on a channel, and your channel's policy settings. You can't edit the name of the channel or CloudFront distribution details.

Any edits you make that impact the video output may not be reflected for a few minutes.

See also: AWS API Documentation

Request Syntax

client.update_channel(
    ChannelGroupName='string',
    ChannelName='string',
    ETag='string',
    Description='string',
    InputSwitchConfiguration={
        'MQCSInputSwitching': True|False,
        'PreferredInput': 123
    },
    OutputHeaderConfiguration={
        'PublishMQCS': True|False
    },
    MultiviewConfiguration={
        'AvailableSources': [
            'string',
        ],
        'AvailableLayouts': [
            'LAYOUT_2EH'|'LAYOUT_2PL'|'LAYOUT_3EL'|'LAYOUT_3PL'|'LAYOUT_4E'|'LAYOUT_4PL',
        ]
    }
)

type ChannelGroupName:

string

param ChannelGroupName:

[REQUIRED]

The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.

type ChannelName:

string

param ChannelName:

[REQUIRED]

The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.

type ETag:

string

param ETag:

The expected current Entity Tag (ETag) for the resource. If the specified ETag does not match the resource's current entity tag, the update request will be rejected.

type Description:

string

param Description:

Any descriptive information that you want to add to the channel for future identification purposes.

type InputSwitchConfiguration:

dict

param InputSwitchConfiguration:

The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when InputType is CMAF.

MQCSInputSwitching (boolean) --

When true, AWS Elemental MediaPackage performs input switching based on the MQCS. Default is false. This setting is valid only when InputType is CMAF.
PreferredInput (integer) --

For CMAF inputs, indicates which input MediaPackage should prefer when both inputs have equal MQCS scores. Select 1 to prefer the first ingest endpoint, or 2 to prefer the second ingest endpoint. If you don't specify a preferred input, MediaPackage uses its default switching behavior when MQCS scores are equal.

type OutputHeaderConfiguration:

dict

param OutputHeaderConfiguration:

The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when InputType is CMAF.

PublishMQCS (boolean) --

When true, AWS Elemental MediaPackage includes the MQCS in responses to the CDN. This setting is valid only when InputType is CMAF.

type MultiviewConfiguration:

dict

param MultiviewConfiguration:

The multiview configuration for the channel. This setting is required when the channel's InputType is MULTIVIEW, and can't be set for any other input type. Because InputType is immutable, you can change a multiview channel's sources and layouts. You can't add or remove the multiview configuration itself.

AvailableSources (list) -- [REQUIRED]

The channels that players can use as tiles in this multiview channel's output. Each source channel must be in the same channel group as the multiview channel, and must have an InputType of CMAF. Only the channels that you list here are available as tiles.
- (string) --
AvailableLayouts (list) -- [REQUIRED]

The tile layouts that players can request from this multiview channel's origin endpoints. Only the layouts that you list here are available. Each layout must appear at most once.
- (string) --
  
  A tile layout for a multiview channel. Each layout determines how many source tiles are composited into the output and how those tiles are arranged.
  
  The allowed values are:
  - LAYOUT_SINGLE – One tile at full resolution. Use this to serve a single source as a standard stream.
  - LAYOUT_2EH – Two tiles of equal size, arranged horizontally.
  - LAYOUT_2PL – Two tiles, with one larger primary tile.
  - LAYOUT_3EB – Three tiles of equal size, with two on top and one below.
  - LAYOUT_3EL – Three tiles of equal size, arranged in two columns.
  - LAYOUT_3PL – Three tiles, with one larger primary tile on the left and two stacked on the right.
  - LAYOUT_4E – Four tiles of equal size, arranged in a two-by-two grid.
  - LAYOUT_4PL – Four tiles, with one larger primary tile on the left and three stacked on the right.

rtype:

dict

returns:

Response Syntax

{
    'MultiviewConfiguration': {
        'AvailableSources': [
            'string',
        ],
        'AvailableLayouts': [
            'LAYOUT_2EH'|'LAYOUT_2PL'|'LAYOUT_3EL'|'LAYOUT_3PL'|'LAYOUT_4E'|'LAYOUT_4PL',
        ]
    },
    'AttachedMultiviewChannels': [
        'string',
    ],
    'Arn': 'string',
    'ChannelName': 'string',
    'ChannelGroupName': 'string',
    'CreatedAt': datetime(2015, 1, 1),
    'ModifiedAt': datetime(2015, 1, 1),
    'Description': 'string',
    'IngestEndpoints': [
        {
            'Id': 'string',
            'Url': 'string'
        },
    ],
    'InputType': 'HLS'|'CMAF'|'MULTIVIEW',
    'ETag': 'string',
    'Tags': {
        'string': 'string'
    },
    'InputSwitchConfiguration': {
        'MQCSInputSwitching': True|False,
        'PreferredInput': 123
    },
    'OutputHeaderConfiguration': {
        'PublishMQCS': True|False
    },
    'OutputLockingMode': 'EPOCH_LOCKED'|'NON_EPOCH_LOCKED'
}

Response Structure

(dict) --
- MultiviewConfiguration (dict) --
  
  The multiview configuration for the channel. This is present only when InputType is MULTIVIEW.
  - AvailableSources (list) --
    
    The channels that players can use as tiles in this multiview channel's output. Each source channel must be in the same channel group as the multiview channel, and must have an InputType of CMAF. Only the channels that you list here are available as tiles.
    - (string) --
  - AvailableLayouts (list) --
    
    The tile layouts that players can request from this multiview channel's origin endpoints. Only the layouts that you list here are available. Each layout must appear at most once.
    - (string) --
      
      A tile layout for a multiview channel. Each layout determines how many source tiles are composited into the output and how those tiles are arranged.
      
      The allowed values are:
      - LAYOUT_SINGLE – One tile at full resolution. Use this to serve a single source as a standard stream.
      - LAYOUT_2EH – Two tiles of equal size, arranged horizontally.
      - LAYOUT_2PL – Two tiles, with one larger primary tile.
      - LAYOUT_3EB – Three tiles of equal size, with two on top and one below.
      - LAYOUT_3EL – Three tiles of equal size, arranged in two columns.
      - LAYOUT_3PL – Three tiles, with one larger primary tile on the left and two stacked on the right.
      - LAYOUT_4E – Four tiles of equal size, arranged in a two-by-two grid.
      - LAYOUT_4PL – Four tiles, with one larger primary tile on the left and three stacked on the right.
- AttachedMultiviewChannels (list) --
  
  The multiview channels, in the same channel group, that list this channel as an available source. This is a read-only field. You can't delete a channel while any multiview channel still lists it as a source. Use this field to find the multiview channels that you need to update first.
  - (string) --
- Arn (string) --
  
  The Amazon Resource Name (ARN) associated with the resource.
- ChannelName (string) --
  
  The name that describes the channel. The name is the primary identifier for the channel, and must be unique for your account in the AWS Region and channel group.
- ChannelGroupName (string) --
  
  The name that describes the channel group. The name is the primary identifier for the channel group, and must be unique for your account in the AWS Region.
- CreatedAt (datetime) --
  
  The date and time the channel was created.
- ModifiedAt (datetime) --
  
  The date and time the channel was modified.
- Description (string) --
  
  The description for your channel.
- IngestEndpoints (list) --
  
  The list of ingest endpoints.
  - (dict) --
    
    The ingest domain URL where the source stream should be sent.
    - Id (string) --
      
      The system-generated unique identifier for the IngestEndpoint.
    - Url (string) --
      
      The ingest domain URL where the source stream should be sent.
- InputType (string) --
  
  The input type is an immutable field. It defines whether the channel allows CMAF ingest, HLS ingest, or server-side multiview output. Multiview channels receive no ingest of their own. If unprovided, the value defaults to HLS.
  
  The allowed values are:
  - HLS - The HLS streaming specification (which defines M3U8 manifests and TS segments).
  - CMAF - The DASH-IF CMAF Ingest specification (which defines CMAF segments with optional DASH manifests).
  - MULTIVIEW – Server-side multiview. The channel receives no ingest of its own. Instead, it composites video from the source channels in its MultiviewConfiguration into a single tiled output stream.
- ETag (string) --
  
  The current Entity Tag (ETag) associated with this resource. The entity tag can be used to safely make concurrent updates to the resource.
- Tags (dict) --
  
  The comma-separated list of tag key:value pairs assigned to the channel.
  - (string) --
    - (string) --
- InputSwitchConfiguration (dict) --
  
  The configuration for input switching based on the media quality confidence score (MQCS) as provided from AWS Elemental MediaLive. This setting is valid only when InputType is CMAF.
  - MQCSInputSwitching (boolean) --
    
    When true, AWS Elemental MediaPackage performs input switching based on the MQCS. Default is false. This setting is valid only when InputType is CMAF.
  - PreferredInput (integer) --
    
    For CMAF inputs, indicates which input MediaPackage should prefer when both inputs have equal MQCS scores. Select 1 to prefer the first ingest endpoint, or 2 to prefer the second ingest endpoint. If you don't specify a preferred input, MediaPackage uses its default switching behavior when MQCS scores are equal.
- OutputHeaderConfiguration (dict) --
  
  The settings for what common media server data (CMSD) headers AWS Elemental MediaPackage includes in responses to the CDN. This setting is valid only when InputType is CMAF.
  - PublishMQCS (boolean) --
    
    When true, AWS Elemental MediaPackage includes the MQCS in responses to the CDN. This setting is valid only when InputType is CMAF.
- OutputLockingMode (string) --
  
  The output locking mode configured for the channel. This value is immutable after channel creation.
  
  The allowed values are:
  - EPOCH_LOCKED - The channel uses epoch-locked behavior with deterministic sequence numbering and fixed segment boundaries aligned to epoch time.
  - NON_EPOCH_LOCKED - The channel uses non-epoch-locked behavior with duration-based segment combining and monotonically increasing sequence numbers starting from 0.