---
title: "POST /subscription/ListLinuxSubscriptionInstances"
method: POST
path: "/subscription/ListLinuxSubscriptionInstances"
---

# POST /subscription/ListLinuxSubscriptionInstances

`POST /subscription/ListLinuxSubscriptionInstances`

Lists the running Amazon EC2 instances that were discovered with commercial Linux subscriptions.

## Request body

- object
  - `Filters` Filter[] — <p>An array of structures that you can use to filter the results by your specified criteria. For example, you can specify <code>Region</code> in the <code>Name</code>, with the <code>contains</code> operator to list all subscriptions that match a partial string in the <code>Value</code>, such as <code>us-west</code>.</p> <p>For each filter, you can specify one of the following values for the <code>Name</code> key to streamline results:</p> <ul> <li> <p> <code>AccountID</code> </p> </li> <li> <p> <code>AmiID</code> </p> </li> <li> <p> <code>DualSubscription</code> </p> </li> <li> <p> <code>InstanceID</code> </p> </li> <li> <p> <code>InstanceType</code> </p> </li> <li> <p> <code>ProductCode</code> </p> </li> <li> <p> <code>Region</code> </p> </li> <li> <p> <code>Status</code> </p> </li> <li> <p> <code>UsageOperation</code> </p> </li> </ul> <p>For each filter, you can use one of the following <code>Operator</code> values to define the behavior of the filter:</p> <ul> <li> <p> <code>contains</code> </p> </li> <li> <p> <code>equals</code> </p> </li> <li> <p> <code>Notequal</code> </p> </li> </ul>
    - `Name` string — The type of name to filter by.
    - `Operator` 'Equal' | 'NotEqual' | 'Contains' — An operator for filtering results.
    - `Values` StringListMemberString[] — One or more values for the name to filter by.
  - `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.

## Response `200`

Success

- ListLinuxSubscriptionInstancesResponse
  - `Instances` Instance[] — An array that contains instance objects.
    - `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` String[] — The product code for the instance. For more information, see <a href="https://docs.aws.amazon.com/license-manager/latest/userguide/linux-subscriptions-usage-operation.html">Usage operation values</a> in the <i>License Manager User Guide</i> .
    - `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 <a href="https://docs.aws.amazon.com/license-manager/latest/userguide/linux-subscriptions-usage-operation.html">Usage operation values</a> in the <i>License Manager User Guide</i>.
  - `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.

## Other responses

- `480` — InternalServerException
- `481` — ThrottlingException
- `482` — ValidationException

---

[API](https://skmtc.net/aws/apis/license-manager-linux-subscriptions.md) · [All operations](https://skmtc.net/aws/apis/license-manager-linux-subscriptions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/license-manager-linux-subscriptions/versions/664cb0d78d42/schema)