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