LicenseManagerLinuxSubscriptions / Paginator / ListLinuxSubscriptionInstances

ListLinuxSubscriptionInstances#

class LicenseManagerLinuxSubscriptions.Paginator.ListLinuxSubscriptionInstances#
paginator = client.get_paginator('list_linux_subscription_instances')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from LicenseManagerLinuxSubscriptions.Client.list_linux_subscription_instances().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Filters=[
        {
            'Name': 'string',
            'Operator': 'Equal'|'NotEqual'|'Contains',
            'Values': [
                'string',
            ]
        },
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • Filters (list) –

    An array of structures that you can use to filter the results by your specified criteria. For example, you can specify Region in the Name, with the contains operator to list all subscriptions that match a partial string in the Value, such as us-west.

    For each filter, you can specify one of the following values for the Name key to streamline results:

    • AccountID

    • AmiID

    • DualSubscription

    • InstanceID

    • InstanceType

    • ProductCode

    • Region

    • Status

    • UsageOperation

    For each filter, you can use one of the following Operator values to define the behavior of the filter:

    • contains

    • equals

    • Notequal

    • (dict) –

      A filter object that is used to return more specific results from a describe operation. Filters can be used to match a set of resources by specific criteria.

      • Name (string) –

        The type of name to filter by.

      • Operator (string) –

        An operator for filtering results.

      • Values (list) –

        One or more values for the name to filter by.

        • (string) –

  • 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

{
    'Instances': [
        {
            'AccountID': 'string',
            'AmiId': 'string',
            'DualSubscription': 'string',
            'InstanceID': 'string',
            'InstanceType': 'string',
            'LastUpdatedTime': 'string',
            'OsVersion': 'string',
            'ProductCode': [
                'string',
            ],
            'Region': 'string',
            'RegisteredWithSubscriptionProvider': 'string',
            'Status': 'string',
            'SubscriptionName': 'string',
            'SubscriptionProviderCreateTime': 'string',
            'SubscriptionProviderUpdateTime': 'string',
            'UsageOperation': 'string'
        },
    ],

}

Response Structure

  • (dict) –

    • Instances (list) –

      An array that contains instance objects.

      • (dict) –

        Details discovered information about a running instance using Linux subscriptions.

        • AccountID (string) –

          The account ID which owns the instance.

        • AmiId (string) –

          The AMI ID used to launch the instance.

        • DualSubscription (string) –

          Indicates that you have two different license subscriptions for the same software on your instance.

        • InstanceID (string) –

          The instance ID of the resource.

        • InstanceType (string) –

          The instance type of the resource.

        • LastUpdatedTime (string) –

          The time in which the last discovery updated the instance details.

        • OsVersion (string) –

          The operating system software version that runs on your instance.

        • ProductCode (list) –

          The product code for the instance. For more information, see Usage operation values in the License Manager User Guide .

          • (string) –

        • Region (string) –

          The Region the instance is running in.

        • RegisteredWithSubscriptionProvider (string) –

          Indicates that your instance uses a BYOL license subscription from a third-party Linux subscription provider that you’ve registered with License Manager.

        • Status (string) –

          The status of the instance.

        • SubscriptionName (string) –

          The name of the license subscription that the instance uses.

        • SubscriptionProviderCreateTime (string) –

          The timestamp when you registered the third-party Linux subscription provider for the subscription that the instance uses.

        • SubscriptionProviderUpdateTime (string) –

          The timestamp from the last time that the instance synced with the registered third-party Linux subscription provider.

        • UsageOperation (string) –

          The usage operation of the instance. For more information, see For more information, see Usage operation values in the License Manager User Guide.