ListChannels

class IVS.Paginator.ListChannels
paginator = client.get_paginator('list_channels')
paginate(**kwargs)

Creates an iterator that will paginate through responses from IVS.Client.list_channels().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    filterByName='string',
    filterByRecordingConfigurationArn='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • filterByName (string) -- Filters the channel list to match the specified name.
  • filterByRecordingConfigurationArn (string) -- Filters the channel list to match the specified recording-configuration ARN.
  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) --

      The size of each page.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'channels': [
        {
            'arn': 'string',
            'authorized': True|False,
            'latencyMode': 'NORMAL'|'LOW',
            'name': 'string',
            'recordingConfigurationArn': 'string',
            'tags': {
                'string': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • channels (list) --

      List of the matching channels.

      • (dict) --

        Summary information about a channel.

        • arn (string) --

          Channel ARN.

        • authorized (boolean) --

          Whether the channel is private (enabled for playback authorization). Default: false .

        • latencyMode (string) --

          Channel latency mode. Use NORMAL to broadcast and deliver live video up to Full HD. Use LOW for near-real-time interaction with viewers. Default: LOW . (Note: In the Amazon IVS console, LOW and NORMAL correspond to Ultra-low and Standard, respectively.)

        • name (string) --

          Channel name.

        • recordingConfigurationArn (string) --

          Recording-configuration ARN. A value other than an empty string indicates that recording is enabled. Default: "" (empty string, recording is disabled).

        • tags (dict) --

          Tags attached to the resource. Array of 1-50 maps, each of the form string:string (key:value) . See Tagging Amazon Web Services Resources for more information, including restrictions that apply to tags and "Tag naming limits and requirements"; Amazon IVS has no service-specific constraints beyond what is documented there.

          • (string) --
            • (string) --
    • NextToken (string) --

      A token to resume pagination.