LicenseManagerUserSubscriptions / Client / list_instances

list_instances#

LicenseManagerUserSubscriptions.Client.list_instances(**kwargs)#

Lists the EC2 instances providing user-based subscriptions.

See also: AWS API Documentation

Request Syntax

response = client.list_instances(
    Filters=[
        {
            'Attribute': 'string',
            'Operation': 'string',
            'Value': 'string'
        },
    ],
    MaxResults=123,
    NextToken='string'
)
Parameters:

  • Filters (list) –

    You can use the following filters to streamline results:

    • Status

    • InstanceId

    • (dict) –

      A filter name and value pair that is used to return more specific results from a describe or list operation. You can use filters can be used to match a set of resources by specific criteria, such as tags, attributes, or IDs.

      • Attribute (string) –

        The name of an attribute to use as a filter.

      • Operation (string) –

        The type of search (For example, eq, geq, leq)

      • Value (string) –

        Value of the filter.

  • MaxResults (integer) – The maximum number of results to return from a single 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

{
    'InstanceSummaries': [
        {
            'InstanceId': 'string',
            'LastStatusCheckDate': 'string',
            'Products': [
                'string',
            ],
            'Status': 'string',
            'StatusMessage': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • InstanceSummaries (list) –

      An array of InstanceSummary resources that contain details about the instances that provide user-based subscriptions and also meet the request criteria.

      • (dict) –

        Describes an EC2 instance providing user-based subscriptions.

        • InstanceId (string) –

          The ID of the EC2 instance, which provides user-based subscriptions.

        • LastStatusCheckDate (string) –

          The date of the last status check.

        • Products (list) –

          A list of provided user-based subscription products.

          • (string) –

        • Status (string) –

          The status of an EC2 instance resource.

        • StatusMessage (string) –

          The status message for an EC2 instance.

    • 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

  • LicenseManagerUserSubscriptions.Client.exceptions.ServiceQuotaExceededException

  • LicenseManagerUserSubscriptions.Client.exceptions.ConflictException

  • LicenseManagerUserSubscriptions.Client.exceptions.ValidationException

  • LicenseManagerUserSubscriptions.Client.exceptions.ThrottlingException

  • LicenseManagerUserSubscriptions.Client.exceptions.InternalServerException

  • LicenseManagerUserSubscriptions.Client.exceptions.ResourceNotFoundException

  • LicenseManagerUserSubscriptions.Client.exceptions.AccessDeniedException