MediaTailor / Client / describe_channel

describe_channel#

MediaTailor.Client.describe_channel(**kwargs)#

Describes a channel. For information about MediaTailor channels, see Working with channels in the MediaTailor User Guide.

See also: AWS API Documentation

Request Syntax

response = client.describe_channel(
    ChannelName='string'
)
Parameters:

ChannelName (string) –

[REQUIRED]

The name of the channel.

Return type:

dict

Returns:

Response Syntax

{
    'Arn': 'string',
    'ChannelName': 'string',
    'ChannelState': 'RUNNING'|'STOPPED',
    'CreationTime': datetime(2015, 1, 1),
    'FillerSlate': {
        'SourceLocationName': 'string',
        'VodSourceName': 'string'
    },
    'LastModifiedTime': datetime(2015, 1, 1),
    'LogConfiguration': {
        'LogTypes': [
            'AS_RUN',
        ]
    },
    'Outputs': [
        {
            'DashPlaylistSettings': {
                'ManifestWindowSeconds': 123,
                'MinBufferTimeSeconds': 123,
                'MinUpdatePeriodSeconds': 123,
                'SuggestedPresentationDelaySeconds': 123
            },
            'HlsPlaylistSettings': {
                'AdMarkupType': [
                    'DATERANGE'|'SCTE35_ENHANCED',
                ],
                'ManifestWindowSeconds': 123
            },
            'ManifestName': 'string',
            'PlaybackUrl': 'string',
            'SourceGroup': 'string'
        },
    ],
    'PlaybackMode': 'string',
    'Tags': {
        'string': 'string'
    },
    'Tier': 'string',
    'TimeShiftConfiguration': {
        'MaxTimeDelaySeconds': 123
    }
}

Response Structure

  • (dict) –

    • Arn (string) –

      The ARN of the channel.

    • ChannelName (string) –

      The name of the channel.

    • ChannelState (string) –

      Indicates whether the channel is in a running state or not.

    • CreationTime (datetime) –

      The timestamp of when the channel was created.

    • FillerSlate (dict) –

      Contains information about the slate used to fill gaps between programs in the schedule.

      • SourceLocationName (string) –

        The name of the source location where the slate VOD source is stored.

      • VodSourceName (string) –

        The slate VOD source name. The VOD source must already exist in a source location before it can be used for slate.

    • LastModifiedTime (datetime) –

      The timestamp of when the channel was last modified.

    • LogConfiguration (dict) –

      The log configuration for the channel.

      • LogTypes (list) –

        The log types.

        • (string) –

    • Outputs (list) –

      The channel’s output properties.

      • (dict) –

        The output item response.

        • DashPlaylistSettings (dict) –

          DASH manifest configuration settings.

          • ManifestWindowSeconds (integer) –

            The total duration (in seconds) of each manifest. Minimum value: 30 seconds. Maximum value: 3600 seconds.

          • MinBufferTimeSeconds (integer) –

            Minimum amount of content (measured in seconds) that a player must keep available in the buffer. Minimum value: 2 seconds. Maximum value: 60 seconds.

          • MinUpdatePeriodSeconds (integer) –

            Minimum amount of time (in seconds) that the player should wait before requesting updates to the manifest. Minimum value: 2 seconds. Maximum value: 60 seconds.

          • SuggestedPresentationDelaySeconds (integer) –

            Amount of time (in seconds) that the player should be from the live point at the end of the manifest. Minimum value: 2 seconds. Maximum value: 60 seconds.

        • HlsPlaylistSettings (dict) –

          HLS manifest configuration settings.

          • AdMarkupType (list) –

            Determines the type of SCTE 35 tags to use in ad markup. Specify DATERANGE to use DATERANGE tags (for live or VOD content). Specify SCTE35_ENHANCED to use EXT-X-CUE-OUT and EXT-X-CUE-IN tags (for VOD content only).

            • (string) –

          • ManifestWindowSeconds (integer) –

            The total duration (in seconds) of each manifest. Minimum value: 30 seconds. Maximum value: 3600 seconds.

        • ManifestName (string) –

          The name of the manifest for the channel that will appear in the channel output’s playback URL.

        • PlaybackUrl (string) –

          The URL used for playback by content players.

        • SourceGroup (string) –

          A string used to associate a package configuration source group with a channel output.

    • PlaybackMode (string) –

      The channel’s playback mode.

    • Tags (dict) –

      The tags assigned to the channel. Tags are key-value pairs that you can associate with Amazon resources to help with organization, access control, and cost tracking. For more information, see Tagging AWS Elemental MediaTailor Resources.

      • (string) –

        • (string) –

    • Tier (string) –

      The channel’s tier.

    • TimeShiftConfiguration (dict) –

      The time-shifted viewing configuration for the channel.

      • MaxTimeDelaySeconds (integer) –

        The maximum time delay for time-shifted viewing. The minimum allowed maximum time delay is 0 seconds, and the maximum allowed maximum time delay is 21600 seconds (6 hours).