IVS

Table of Contents

Client

class IVS.Client

A low-level client representing Amazon Interactive Video Service (IVS):

import boto3

client = boto3.client('ivs')

These are the available methods:

batch_get_channel(**kwargs)

Performs GetChannel on multiple ARNs simultaneously.

See also: AWS API Documentation

Request Syntax

response = client.batch_get_channel(
    arns=[
        'string',
    ]
)
Parameters
arns (list) --

[REQUIRED]

Array of ARNs, one per channel.

  • (string) --
Return type
dict
Returns
Response Syntax
{
    'channels': [
        {
            'arn': 'string',
            'name': 'string',
            'latencyMode': 'NORMAL'|'LOW',
            'type': 'BASIC'|'STANDARD',
            'ingestEndpoint': 'string',
            'playbackUrl': 'string',
            'tags': {
                'string': 'string'
            }
        },
    ],
    'errors': [
        {
            'arn': 'string',
            'code': 'string',
            'message': 'string'
        },
    ]
}

Response Structure

  • (dict) --
    • channels (list) --
      • (dict) --

        Object specifying a channel.

        • arn (string) --

          Channel ARN.

        • name (string) --

          Channel name.

        • latencyMode (string) --

          Channel latency mode. Default: LOW .

        • type (string) --

          Channel type, which determines the allowable resolution and bitrate. STANDARD: The stream is transcoded; resolution (width, in landscape orientation) can be up to 1080p or the input source resolution, whichever is lower; and bitrate can be up to 8.5 Mbps. BASIC: The stream is transfixed; resolution can be up to 480p; and bitrate can be up to 1.5 Mbps. Default STANDARD.

        • ingestEndpoint (string) --

          Channel ingest endpoint, part of the definition of an ingest server, used when you set up streaming software.

        • playbackUrl (string) --

          Channel playback URL.

        • tags (dict) --

          Array of 1-50 maps, each of the form string:string (key:value) .

          • (string) --
            • (string) --
    • errors (list) --

      Each error object is related to a specific ARN in the request.

      • (dict) --

        Error related to a specific channel, specified by its ARN.

        • arn (string) --

          Channel ARN.

        • code (string) --

          Error code.

        • message (string) --

          Error message, determined by the application.

batch_get_stream_key(**kwargs)

Performs GetStreamKey on multiple ARNs simultaneously.

See also: AWS API Documentation

Request Syntax

response = client.batch_get_stream_key(
    arns=[
        'string',
    ]
)
Parameters
arns (list) --

[REQUIRED]

Array of ARNs, one per channel.

  • (string) --
Return type
dict
Returns
Response Syntax
{
    'streamKeys': [
        {
            'arn': 'string',
            'value': 'string',
            'channelArn': 'string',
            'tags': {
                'string': 'string'
            }
        },
    ],
    'errors': [
        {
            'arn': 'string',
            'code': 'string',
            'message': 'string'
        },
    ]
}

Response Structure

  • (dict) --
    • streamKeys (list) --
      • (dict) --

        Object specifying a stream key.

        • arn (string) --

          Stream-key ARN.

        • value (string) --

          Stream-key value.

        • channelArn (string) --

          Channel ARN for the stream.

        • tags (dict) --

          Array of 1-50 maps, each of the form string:string (key:value)

          • (string) --
            • (string) --
    • errors (list) --
      • (dict) --

        Error related to a specific channel, specified by its ARN.

        • arn (string) --

          Channel ARN.

        • code (string) --

          Error code.

        • message (string) --

          Error message, determined by the application.

can_paginate(operation_name)

Check if an operation can be paginated.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Returns
True if the operation can be paginated, False otherwise.
create_channel(**kwargs)

Creates a new channel and an associated stream key to start streaming.

See also: AWS API Documentation

Request Syntax

response = client.create_channel(
    name='string',
    latencyMode='NORMAL'|'LOW',
    type='BASIC'|'STANDARD',
    tags={
        'string': 'string'
    }
)
Parameters
  • name (string) -- Channel name.
  • latencyMode (string) -- Channel latency mode. Default: LOW .
  • type (string) -- Channel type, which determines the allowable resolution and bitrate. STANDARD : The stream is transcoded; resolution (width, in landscape orientation) can be up to 1080p or the input source resolution, whichever is lower; and bitrate can be up to 8.5 Mbps. BASIC : The stream is transfixed; resolution can be up to 480p; and bitrate can be up to 1.5 Mbps. Default: STANDARD .
  • tags (dict) --

    See Channel$tags .

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'channel': {
        'arn': 'string',
        'name': 'string',
        'latencyMode': 'NORMAL'|'LOW',
        'type': 'BASIC'|'STANDARD',
        'ingestEndpoint': 'string',
        'playbackUrl': 'string',
        'tags': {
            'string': 'string'
        }
    },
    'streamKey': {
        'arn': 'string',
        'value': 'string',
        'channelArn': 'string',
        'tags': {
            'string': 'string'
        }
    }
}

Response Structure

  • (dict) --

    • channel (dict) --

      Object specifying a channel.

      • arn (string) --

        Channel ARN.

      • name (string) --

        Channel name.

      • latencyMode (string) --

        Channel latency mode. Default: LOW .

      • type (string) --

        Channel type, which determines the allowable resolution and bitrate. STANDARD: The stream is transcoded; resolution (width, in landscape orientation) can be up to 1080p or the input source resolution, whichever is lower; and bitrate can be up to 8.5 Mbps. BASIC: The stream is transfixed; resolution can be up to 480p; and bitrate can be up to 1.5 Mbps. Default STANDARD.

      • ingestEndpoint (string) --

        Channel ingest endpoint, part of the definition of an ingest server, used when you set up streaming software.

      • playbackUrl (string) --

        Channel playback URL.

      • tags (dict) --

        Array of 1-50 maps, each of the form string:string (key:value) .

        • (string) --
          • (string) --
    • streamKey (dict) --

      Object specifying a stream key.

      • arn (string) --

        Stream-key ARN.

      • value (string) --

        Stream-key value.

      • channelArn (string) --

        Channel ARN for the stream.

      • tags (dict) --

        Array of 1-50 maps, each of the form string:string (key:value)

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

Exceptions

  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.AccessDeniedException
  • IVS.Client.exceptions.ServiceQuotaExceededException
create_stream_key(**kwargs)

Creates a stream key, used to initiate a stream, for a specified channel ARN.

Note that CreateChannel creates a stream key. If you subsequently use CreateStreamKey on the same channel, it will fail because a stream key already exists and there is a limit of 1 stream key per channel. To reset the stream key on a channel, use DeleteStreamKey and then CreateStreamKey.

See also: AWS API Documentation

Request Syntax

response = client.create_stream_key(
    channelArn='string',
    tags={
        'string': 'string'
    }
)
Parameters
  • channelArn (string) --

    [REQUIRED]

    ARN of the channel for which to create the stream key.

  • tags (dict) --

    See Channel$tags .

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'streamKey': {
        'arn': 'string',
        'value': 'string',
        'channelArn': 'string',
        'tags': {
            'string': 'string'
        }
    }
}

Response Structure

  • (dict) --

    • streamKey (dict) --

      Stream key used to authenticate an RTMP stream for ingestion.

      • arn (string) --

        Stream-key ARN.

      • value (string) --

        Stream-key value.

      • channelArn (string) --

        Channel ARN for the stream.

      • tags (dict) --

        Array of 1-50 maps, each of the form string:string (key:value)

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

Exceptions

  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.AccessDeniedException
  • IVS.Client.exceptions.ResourceNotFoundException
  • IVS.Client.exceptions.ServiceQuotaExceededException
delete_channel(**kwargs)

Deletes a specified channel and its associated stream keys.

See also: AWS API Documentation

Request Syntax

response = client.delete_channel(
    arn='string'
)
Parameters
arn (string) --

[REQUIRED]

ARN of the channel to be deleted.

Returns
None

Exceptions

  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.AccessDeniedException
  • IVS.Client.exceptions.ResourceNotFoundException
  • IVS.Client.exceptions.ConflictException
delete_stream_key(**kwargs)

Deletes the stream key for a specified ARN, so it can no longer be used to stream.

See also: AWS API Documentation

Request Syntax

response = client.delete_stream_key(
    arn='string'
)
Parameters
arn (string) --

[REQUIRED]

ARN of the stream key to be deleted.

Returns
None

Exceptions

  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.AccessDeniedException
  • IVS.Client.exceptions.ResourceNotFoundException
generate_presigned_url(ClientMethod, Params=None, ExpiresIn=3600, HttpMethod=None)

Generate a presigned url given a client, its method, and arguments

Parameters
  • ClientMethod (string) -- The client method to presign for
  • Params (dict) -- The parameters normally passed to ClientMethod.
  • ExpiresIn (int) -- The number of seconds the presigned url is valid for. By default it expires in an hour (3600 seconds)
  • HttpMethod (string) -- The http method to use on the generated url. By default, the http method is whatever is used in the method's model.
Returns

The presigned url

get_channel(**kwargs)

Gets the channel configuration for a specified channel ARN. See also BatchGetChannel .

See also: AWS API Documentation

Request Syntax

response = client.get_channel(
    arn='string'
)
Parameters
arn (string) --

[REQUIRED]

ARN of the channel for which the configuration is to be retrieved.

Return type
dict
Returns
Response Syntax
{
    'channel': {
        'arn': 'string',
        'name': 'string',
        'latencyMode': 'NORMAL'|'LOW',
        'type': 'BASIC'|'STANDARD',
        'ingestEndpoint': 'string',
        'playbackUrl': 'string',
        'tags': {
            'string': 'string'
        }
    }
}

Response Structure

  • (dict) --
    • channel (dict) --

      Object specifying a channel.

      • arn (string) --

        Channel ARN.

      • name (string) --

        Channel name.

      • latencyMode (string) --

        Channel latency mode. Default: LOW .

      • type (string) --

        Channel type, which determines the allowable resolution and bitrate. STANDARD: The stream is transcoded; resolution (width, in landscape orientation) can be up to 1080p or the input source resolution, whichever is lower; and bitrate can be up to 8.5 Mbps. BASIC: The stream is transfixed; resolution can be up to 480p; and bitrate can be up to 1.5 Mbps. Default STANDARD.

      • ingestEndpoint (string) --

        Channel ingest endpoint, part of the definition of an ingest server, used when you set up streaming software.

      • playbackUrl (string) --

        Channel playback URL.

      • tags (dict) --

        Array of 1-50 maps, each of the form string:string (key:value) .

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

Exceptions

  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.AccessDeniedException
  • IVS.Client.exceptions.ResourceNotFoundException
get_paginator(operation_name)

Create a paginator for an operation.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Raises OperationNotPageableError
Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.
Return type
L{botocore.paginate.Paginator}
Returns
A paginator object.
get_stream(**kwargs)

Gets information about the active (live) stream on a specified channel.

See also: AWS API Documentation

Request Syntax

response = client.get_stream(
    channelArn='string'
)
Parameters
channelArn (string) --

[REQUIRED]

Channel ARN for stream to be accessed.

Return type
dict
Returns
Response Syntax
{
    'stream': {
        'channelArn': 'string',
        'playbackUrl': 'string',
        'startTime': datetime(2015, 1, 1),
        'state': 'LIVE'|'OFFLINE',
        'health': 'HEALTHY'|'STARVING'|'UNKNOWN',
        'viewerCount': 123
    }
}

Response Structure

  • (dict) --
    • stream (dict) --

      Specifies a live video stream that has been ingested and distributed.

      • channelArn (string) --

        Channel ARN for the stream.

      • playbackUrl (string) --

        URL of the video master manifest, required by the video player to play the HLS stream.

      • startTime (datetime) --

        ISO-8601 formatted timestamp of the stream’s start.

      • state (string) --

        The stream’s state.

      • health (string) --

        The stream’s health.

      • viewerCount (integer) --

        Number of current viewers of the stream.

Exceptions

  • IVS.Client.exceptions.ResourceNotFoundException
  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.AccessDeniedException
  • IVS.Client.exceptions.ChannelNotBroadcasting
get_stream_key(**kwargs)

Gets stream-key information for a specified ARN.

See also: AWS API Documentation

Request Syntax

response = client.get_stream_key(
    arn='string'
)
Parameters
arn (string) --

[REQUIRED]

ARN for the stream key to be retrieved.

Return type
dict
Returns
Response Syntax
{
    'streamKey': {
        'arn': 'string',
        'value': 'string',
        'channelArn': 'string',
        'tags': {
            'string': 'string'
        }
    }
}

Response Structure

  • (dict) --
    • streamKey (dict) --

      Object specifying a stream key.

      • arn (string) --

        Stream-key ARN.

      • value (string) --

        Stream-key value.

      • channelArn (string) --

        Channel ARN for the stream.

      • tags (dict) --

        Array of 1-50 maps, each of the form string:string (key:value)

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

Exceptions

  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.AccessDeniedException
  • IVS.Client.exceptions.ResourceNotFoundException
get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters
waiter_name (str) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
Returns
The specified waiter object.
Return type
botocore.waiter.Waiter
list_channels(**kwargs)

Gets summary information about channels. This list can be filtered to match a specified string.

See also: AWS API Documentation

Request Syntax

response = client.list_channels(
    filterByName='string',
    nextToken='string',
    maxResults=123
)
Parameters
  • filterByName (string) -- Filters the channel list to match the specified name.
  • nextToken (string) -- The first channel to retrieve. This is used for pagination; see the nextToken response field.
  • maxResults (integer) -- Maximum number of channels to return.
Return type

dict

Returns

Response Syntax

{
    'channels': [
        {
            'arn': 'string',
            'name': 'string',
            'latencyMode': 'NORMAL'|'LOW',
            '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.

        • name (string) --

          Channel name.

        • latencyMode (string) --

          Channel latency mode. Default: LOW .

        • tags (dict) --

          Array of 1-50 maps, each of the form string:string (key:value) .

          • (string) --
            • (string) --
    • nextToken (string) --

      If there are more channels than maxResults , use nextToken in the request to get the next set.

Exceptions

  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.AccessDeniedException
list_stream_keys(**kwargs)

Gets summary information about stream keys. The list can be filtered to a particular channel.

See also: AWS API Documentation

Request Syntax

response = client.list_stream_keys(
    channelArn='string',
    nextToken='string',
    maxResults=123
)
Parameters
  • channelArn (string) --

    [REQUIRED]

    Channel ARN used to filter the list.

  • nextToken (string) -- The first stream key to retrieve. This is used for pagination; see the nextToken response field.
  • maxResults (integer) -- Maximum number of streamKeys to return.
Return type

dict

Returns

Response Syntax

{
    'streamKeys': [
        {
            'arn': 'string',
            'channelArn': 'string',
            'tags': {
                'string': 'string'
            }
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • streamKeys (list) --

      List of stream keys.

      • (dict) --

        Summary information about a stream key.

        • arn (string) --

          Stream-key ARN.

        • channelArn (string) --

          Channel ARN for the stream.

        • tags (dict) --

          Array of 1-50 maps, each of the form string:string (key:value)

          • (string) --
            • (string) --
    • nextToken (string) --

      If there are more stream keys than maxResults , use nextToken in the request to get the next set.

Exceptions

  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.AccessDeniedException
  • IVS.Client.exceptions.ResourceNotFoundException
list_streams(**kwargs)

Gets summary information about live streams.

See also: AWS API Documentation

Request Syntax

response = client.list_streams(
    nextToken='string',
    maxResults=123
)
Parameters
  • nextToken (string) -- The first stream to retrieve. This is used for pagination; see the nextToken response field.
  • maxResults (integer) -- Maximum number of streams to return.
Return type

dict

Returns

Response Syntax

{
    'streams': [
        {
            'channelArn': 'string',
            'state': 'LIVE'|'OFFLINE',
            'health': 'HEALTHY'|'STARVING'|'UNKNOWN',
            'viewerCount': 123,
            'startTime': datetime(2015, 1, 1)
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • streams (list) --

      List of streams.

      • (dict) --

        Summary information about a stream.

        • channelArn (string) --

          Channel ARN for the stream.

        • state (string) --

          The stream’s state.

        • health (string) --

          The stream’s health.

        • viewerCount (integer) --

          Number of current viewers of the stream.

        • startTime (datetime) --

          ISO-8601 formatted timestamp of the stream’s start.

    • nextToken (string) --

      If there are more streams than maxResults , use nextToken in the request to get the next set.

Exceptions

  • IVS.Client.exceptions.AccessDeniedException
list_tags_for_resource(**kwargs)

Gets information about the tags for a specified ARN.

See also: AWS API Documentation

Request Syntax

response = client.list_tags_for_resource(
    resourceArn='string',
    nextToken='string',
    maxResults=123
)
Parameters
  • resourceArn (string) --

    [REQUIRED]

    The ARN of the resource to be retrieved.

  • nextToken (string) -- The first tag to retrieve. This is used for pagination; see the nextToken response field.
  • maxResults (integer) -- Maximum number of tags to return.
Return type

dict

Returns

Response Syntax

{
    'tags': {
        'string': 'string'
    },
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • tags (dict) --

      • (string) --
        • (string) --
    • nextToken (string) --

      If there are more tags than maxResults , use nextToken in the request to get the next set.

Exceptions

  • IVS.Client.exceptions.InternalServerException
  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.ResourceNotFoundException
put_metadata(**kwargs)

Inserts metadata into an RTMP stream for a specified channel. A maximum of 5 requests per second per channel is allowed, each with a maximum 1KB payload.

See also: AWS API Documentation

Request Syntax

response = client.put_metadata(
    channelArn='string',
    metadata='string'
)
Parameters
  • channelArn (string) --

    [REQUIRED]

    ARN of the channel into which metadata is inserted. This channel must have an active stream.

  • metadata (string) --

    [REQUIRED]

    Metadata to insert into the stream. Maximum: 1 KB per request.

Returns

None

Exceptions

  • IVS.Client.exceptions.ThrottlingException
  • IVS.Client.exceptions.ResourceNotFoundException
  • IVS.Client.exceptions.ChannelNotBroadcasting
  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.AccessDeniedException
stop_stream(**kwargs)

Disconnects the stream for the specified channel. This disconnects the incoming RTMP stream from the client. Can be used in conjunction with DeleteStreamKey to prevent further streaming to a channel.

Note

Many streaming client-software libraries automatically reconnect a dropped RTMP session, so to stop the stream permanently, you may want to first revoke the streamKey attached to the channel.

See also: AWS API Documentation

Request Syntax

response = client.stop_stream(
    channelArn='string'
)
Parameters
channelArn (string) --

[REQUIRED]

ARN of the channel for which the stream is to be stopped.

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --

Exceptions

  • IVS.Client.exceptions.ResourceNotFoundException
  • IVS.Client.exceptions.ChannelNotBroadcasting
  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.AccessDeniedException
  • IVS.Client.exceptions.StreamUnavailable
tag_resource(**kwargs)

Adds or updates tags for a resource with a specified ARN.

See also: AWS API Documentation

Request Syntax

response = client.tag_resource(
    resourceArn='string',
    tags={
        'string': 'string'
    }
)
Parameters
  • resourceArn (string) --

    [REQUIRED]

    ARN of the resource for which tags are to be added or updated.

  • tags (dict) --

    [REQUIRED]

    Array of tags to be added or updated.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

Exceptions

  • IVS.Client.exceptions.InternalServerException
  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.ResourceNotFoundException
untag_resource(**kwargs)

Removes tags for a resource with a specified ARN.

See also: AWS API Documentation

Request Syntax

response = client.untag_resource(
    resourceArn='string',
    tagKeys=[
        'string',
    ]
)
Parameters
  • resourceArn (string) --

    [REQUIRED]

    ARN of the resource for which tags are to be removed.

  • tagKeys (list) --

    [REQUIRED]

    Array of tags to be removed.

    • (string) --
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

Exceptions

  • IVS.Client.exceptions.InternalServerException
  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.ResourceNotFoundException
update_channel(**kwargs)

Updates a channel's configuration. This does not affect an ongoing stream of this channel. You must stop and restart the stream for the changes to take effect.

See also: AWS API Documentation

Request Syntax

response = client.update_channel(
    arn='string',
    name='string',
    latencyMode='NORMAL'|'LOW',
    type='BASIC'|'STANDARD'
)
Parameters
  • arn (string) --

    [REQUIRED]

    ARN of the channel to be updated.

  • name (string) -- Channel name.
  • latencyMode (string) -- Channel latency mode. Default: LOW .
  • type (string) -- Channel type, which determines the allowable resolution and bitrate. STANDARD : The stream is transcoded; resolution (width, in landscape orientation) can be up to 1080p or the input source resolution, whichever is lower; and bitrate can be up to 8.5 Mbps. BASIC : The stream is transfixed; resolution can be up to 480p; and bitrate can be up to 1.5 Mbps. Default STANDARD .
Return type

dict

Returns

Response Syntax

{
    'channel': {
        'arn': 'string',
        'name': 'string',
        'latencyMode': 'NORMAL'|'LOW',
        'type': 'BASIC'|'STANDARD',
        'ingestEndpoint': 'string',
        'playbackUrl': 'string',
        'tags': {
            'string': 'string'
        }
    }
}

Response Structure

  • (dict) --

    • channel (dict) --

      Object specifying a channel.

      • arn (string) --

        Channel ARN.

      • name (string) --

        Channel name.

      • latencyMode (string) --

        Channel latency mode. Default: LOW .

      • type (string) --

        Channel type, which determines the allowable resolution and bitrate. STANDARD: The stream is transcoded; resolution (width, in landscape orientation) can be up to 1080p or the input source resolution, whichever is lower; and bitrate can be up to 8.5 Mbps. BASIC: The stream is transfixed; resolution can be up to 480p; and bitrate can be up to 1.5 Mbps. Default STANDARD.

      • ingestEndpoint (string) --

        Channel ingest endpoint, part of the definition of an ingest server, used when you set up streaming software.

      • playbackUrl (string) --

        Channel playback URL.

      • tags (dict) --

        Array of 1-50 maps, each of the form string:string (key:value) .

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

Exceptions

  • IVS.Client.exceptions.ValidationException
  • IVS.Client.exceptions.AccessDeniedException
  • IVS.Client.exceptions.ResourceNotFoundException
  • IVS.Client.exceptions.ConflictException

Paginators

The available paginators are:

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',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • filterByName (string) -- Filters the channel list to match the specified name.
  • 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',
            'name': 'string',
            'latencyMode': 'NORMAL'|'LOW',
            '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.

        • name (string) --

          Channel name.

        • latencyMode (string) --

          Channel latency mode. Default: LOW .

        • tags (dict) --

          Array of 1-50 maps, each of the form string:string (key:value) .

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

      A token to resume pagination.

class IVS.Paginator.ListStreamKeys
paginator = client.get_paginator('list_stream_keys')
paginate(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    channelArn='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • channelArn (string) --

    [REQUIRED]

    Channel ARN used to filter the list.

  • 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

{
    'streamKeys': [
        {
            'arn': 'string',
            'channelArn': 'string',
            'tags': {
                'string': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • streamKeys (list) --

      List of stream keys.

      • (dict) --

        Summary information about a stream key.

        • arn (string) --

          Stream-key ARN.

        • channelArn (string) --

          Channel ARN for the stream.

        • tags (dict) --

          Array of 1-50 maps, each of the form string:string (key:value)

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

      A token to resume pagination.

class IVS.Paginator.ListStreams
paginator = client.get_paginator('list_streams')
paginate(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
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
{
    'streams': [
        {
            'channelArn': 'string',
            'state': 'LIVE'|'OFFLINE',
            'health': 'HEALTHY'|'STARVING'|'UNKNOWN',
            'viewerCount': 123,
            'startTime': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --
    • streams (list) --

      List of streams.

      • (dict) --

        Summary information about a stream.

        • channelArn (string) --

          Channel ARN for the stream.

        • state (string) --

          The stream’s state.

        • health (string) --

          The stream’s health.

        • viewerCount (integer) --

          Number of current viewers of the stream.

        • startTime (datetime) --

          ISO-8601 formatted timestamp of the stream’s start.

    • NextToken (string) --

      A token to resume pagination.