list_instances

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

    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.

    • (dict) --

      A filter name and value pair 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, 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) -- 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

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

Response Structure

  • (dict) --

    • InstanceSummaries (list) --

      Metadata that describes the list instances operation.

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

      Token for the next set of results.

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