LicenseManagerLinuxSubscriptions / Client / list_linux_subscriptions

list_linux_subscriptions#

LicenseManagerLinuxSubscriptions.Client.list_linux_subscriptions(**kwargs)#

Lists the Linux subscriptions that have been discovered. If you have linked your organization, the returned results will include data aggregated across your accounts in Organizations.

See also: AWS API Documentation

Request Syntax

response = client.list_linux_subscriptions(
    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 Subscription with an optional operator to see subscriptions that match, partially match, or don’t match a certain subscription’s name.

    The valid names for this filter are:

    • Subscription

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

{
    'NextToken': 'string',
    'Subscriptions': [
        {
            'InstanceCount': 123,
            'Name': 'string',
            'Type': 'string'
        },
    ]
}

Response Structure

  • (dict) –

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

    • Subscriptions (list) –

      An array that contains subscription objects.

      • (dict) –

        An object which details a discovered Linux subscription.

        • InstanceCount (integer) –

          The total amount of running instances using this subscription.

        • Name (string) –

          The name of the subscription.

        • Type (string) –

          The type of subscription. The type can be subscription-included with Amazon EC2, Bring Your Own Subscription model (BYOS), or from the Amazon Web Services Marketplace. Certain subscriptions may use licensing from the Amazon Web Services Marketplace as well as OS licensing from Amazon EC2 or BYOS.

Exceptions