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

  • MaxResults (integer) – The maximum items to return in a request.

  • NextToken (string) – A token to specify where to start paginating. This is the nextToken from a previously truncated 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'
        },
    ],
    '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.

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

    • NextToken (string) –

      The next token used for paginated responses. When this field isn’t empty, there are additional elements that the service hasn’t included in this request. Use this token with the next request to retrieve additional objects.

Exceptions