LicenseManagerLinuxSubscriptions / Client / list_linux_subscription_instances

list_linux_subscription_instances

LicenseManagerLinuxSubscriptions.Client.list_linux_subscription_instances(**kwargs)

Lists the running Amazon EC2 instances that were discovered with commercial Linux subscriptions.

See also: AWS API Documentation

Request Syntax

response = client.list_linux_subscription_instances(
    Filters=[
        {
            'Name': 'string',
            'Operator': 'Equal'|'NotEqual'|'Contains',
            'Values': [
                'string',
            ]
        },
    ],
    MaxResults=123,
    NextToken='string'
)

Parameters:

• Filters (list) –

  An array of structures that you can use to filter the results to those that match one or more sets of key-value pairs that you specify. For example, you can filter by the name of AmiID with an optional operator to see subscriptions that match, partially match, or don’t match a certain Amazon Machine Image (AMI) ID.

  The valid names for this filter are:

  • AmiID

  • InstanceID

  • AccountID

  • Status

  • Region

  • UsageOperation

  • ProductCode

  • InstanceType

  The valid Operators for this filter are:

  • 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) –

• MaxResults (integer) – Maximum number of results to return in a single call.

• NextToken (string) – Token for the next set of results.

Return type:

dict

Returns:

Response Syntax

{
    'Instances': [
        {
            'AccountID': 'string',
            'AmiId': 'string',
            'InstanceID': 'string',
            'InstanceType': 'string',
            'LastUpdatedTime': 'string',
            'ProductCode': [
                'string',
            ],
            'Region': 'string',
            'Status': 'string',
            'SubscriptionName': 'string',
            'UsageOperation': 'string'
        },
    ],
    'NextToken': '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.

      • 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.

      • 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.

      • Status (string) –

        The status of the instance.

      • SubscriptionName (string) –

        The name of the subscription being used by the instance.

      • 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.

  • NextToken (string) –

    Token for the next set of results.

Exceptions

• LicenseManagerLinuxSubscriptions.Client.exceptions.InternalServerException

• LicenseManagerLinuxSubscriptions.Client.exceptions.ThrottlingException

• LicenseManagerLinuxSubscriptions.Client.exceptions.ValidationException