Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

ListReservations

class MediaLive.Paginator.ListReservations
paginator = client.get_paginator('list_reservations')
paginate(**kwargs)

Creates an iterator that will paginate through responses from MediaLive.Client.list_reservations().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    ChannelClass='string',
    Codec='string',
    MaximumBitrate='string',
    MaximumFramerate='string',
    Resolution='string',
    ResourceType='string',
    SpecialFeature='string',
    VideoQuality='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • ChannelClass (string) -- Filter by channel class, 'STANDARD' or 'SINGLE_PIPELINE'
  • Codec (string) -- Filter by codec, 'AVC', 'HEVC', 'MPEG2', 'AUDIO', or 'LINK'
  • MaximumBitrate (string) -- Filter by bitrate, 'MAX_10_MBPS', 'MAX_20_MBPS', or 'MAX_50_MBPS'
  • MaximumFramerate (string) -- Filter by framerate, 'MAX_30_FPS' or 'MAX_60_FPS'
  • Resolution (string) -- Filter by resolution, 'SD', 'HD', 'FHD', or 'UHD'
  • ResourceType (string) -- Filter by resource type, 'INPUT', 'OUTPUT', 'MULTIPLEX', or 'CHANNEL'
  • SpecialFeature (string) -- Filter by special feature, 'ADVANCED_AUDIO' or 'AUDIO_NORMALIZATION'
  • VideoQuality (string) -- Filter by video quality, 'STANDARD', 'ENHANCED', or 'PREMIUM'
  • 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

{
    'Reservations': [
        {
            'Arn': 'string',
            'Count': 123,
            'CurrencyCode': 'string',
            'Duration': 123,
            'DurationUnits': 'MONTHS',
            'End': 'string',
            'FixedPrice': 123.0,
            'Name': 'string',
            'OfferingDescription': 'string',
            'OfferingId': 'string',
            'OfferingType': 'NO_UPFRONT',
            'Region': 'string',
            'RenewalSettings': {
                'AutomaticRenewal': 'DISABLED'|'ENABLED'|'UNAVAILABLE',
                'RenewalCount': 123
            },
            'ReservationId': 'string',
            'ResourceSpecification': {
                'ChannelClass': 'STANDARD'|'SINGLE_PIPELINE',
                'Codec': 'MPEG2'|'AVC'|'HEVC'|'AUDIO'|'LINK',
                'MaximumBitrate': 'MAX_10_MBPS'|'MAX_20_MBPS'|'MAX_50_MBPS',
                'MaximumFramerate': 'MAX_30_FPS'|'MAX_60_FPS',
                'Resolution': 'SD'|'HD'|'FHD'|'UHD',
                'ResourceType': 'INPUT'|'OUTPUT'|'MULTIPLEX'|'CHANNEL',
                'SpecialFeature': 'ADVANCED_AUDIO'|'AUDIO_NORMALIZATION'|'MGHD'|'MGUHD',
                'VideoQuality': 'STANDARD'|'ENHANCED'|'PREMIUM'
            },
            'Start': 'string',
            'State': 'ACTIVE'|'EXPIRED'|'CANCELED'|'DELETED',
            'Tags': {
                'string': 'string'
            },
            'UsagePrice': 123.0
        },
    ]
}

Response Structure

  • (dict) -- List of reservations
    • Reservations (list) -- List of reservations
      • (dict) -- Reserved resources available to use
        • Arn (string) -- Unique reservation ARN, e.g. 'arn:aws:medialive:us-west-2:123456789012:reservation:1234567'
        • Count (integer) -- Number of reserved resources
        • CurrencyCode (string) -- Currency code for usagePrice and fixedPrice in ISO-4217 format, e.g. 'USD'
        • Duration (integer) -- Lease duration, e.g. '12'
        • DurationUnits (string) -- Units for duration, e.g. 'MONTHS'
        • End (string) -- Reservation UTC end date and time in ISO-8601 format, e.g. '2019-03-01T00:00:00'
        • FixedPrice (float) -- One-time charge for each reserved resource, e.g. '0.0' for a NO_UPFRONT offering
        • Name (string) -- User specified reservation name
        • OfferingDescription (string) -- Offering description, e.g. 'HD AVC output at 10-20 Mbps, 30 fps, and standard VQ in US West (Oregon)'
        • OfferingId (string) -- Unique offering ID, e.g. '87654321'
        • OfferingType (string) -- Offering type, e.g. 'NO_UPFRONT'
        • Region (string) -- AWS region, e.g. 'us-west-2'
        • RenewalSettings (dict) -- Renewal settings for the reservation
          • AutomaticRenewal (string) -- Automatic renewal status for the reservation
          • RenewalCount (integer) -- Count for the reservation renewal
        • ReservationId (string) -- Unique reservation ID, e.g. '1234567'
        • ResourceSpecification (dict) -- Resource configuration details
          • ChannelClass (string) -- Channel class, e.g. 'STANDARD'
          • Codec (string) -- Codec, e.g. 'AVC'
          • MaximumBitrate (string) -- Maximum bitrate, e.g. 'MAX_20_MBPS'
          • MaximumFramerate (string) -- Maximum framerate, e.g. 'MAX_30_FPS' (Outputs only)
          • Resolution (string) -- Resolution, e.g. 'HD'
          • ResourceType (string) -- Resource type, 'INPUT', 'OUTPUT', 'MULTIPLEX', or 'CHANNEL'
          • SpecialFeature (string) -- Special feature, e.g. 'AUDIO_NORMALIZATION' (Channels only)
          • VideoQuality (string) -- Video quality, e.g. 'STANDARD' (Outputs only)
        • Start (string) -- Reservation UTC start date and time in ISO-8601 format, e.g. '2018-03-01T00:00:00'
        • State (string) -- Current state of reservation, e.g. 'ACTIVE'
        • Tags (dict) -- A collection of key-value pairs
          • (string) -- Placeholder documentation for __string
            • (string) -- Placeholder documentation for __string
        • UsagePrice (float) -- Recurring usage charge for each reserved resource, e.g. '157.0'