---
title: "POST /#X-Amz-Target=AWSServerMigrationService_V2016_10_24.GetServers"
method: POST
path: "/#X-Amz-Target=AWSServerMigrationService_V2016_10_24.GetServers"
---

# POST /#X-Amz-Target=AWSServerMigrationService_V2016_10_24.GetServers

`POST /#X-Amz-Target=AWSServerMigrationService_V2016_10_24.GetServers`

Describes the servers in your server catalog.

Before you can describe your servers, you must import them using ImportServerCatalog.

## Query parameters

- `maxResults` string
- `nextToken` string

## Headers

- `X-Amz-Target` 'AWSServerMigrationService_V2016_10_24.GetServers', required

## Request body

- GetServersRequest
  - `nextToken` string — The token for the next set of results.
  - `maxResults` integer — The maximum number of results to return in a single call. The default value is 50. To retrieve the remaining results, make another call with the returned <code>NextToken</code> value.
  - `vmServerAddressList` VmServerAddress[] — The server addresses.
    - `vmManagerId` string — The ID of the VM manager.
    - `vmId` string — The ID of the VM.

## Response `200`

Success

- GetServersResponse
  - `lastModifiedOn` string, date-time — The time when the server was last modified.
  - `serverCatalogStatus` 'NOT_IMPORTED' | 'IMPORTING' | 'AVAILABLE' | 'DELETED' | 'EXPIRED' — The status of the server catalog.
  - `serverList` Server[] — Information about the servers.
    - `serverId` string — The ID of the server.
    - `serverType` 'VIRTUAL_MACHINE' — The type of server.
    - `vmServer` object — Information about the VM server.
      - `vmServerAddress` object — The VM server location.
        - `vmManagerId` string — The ID of the VM manager.
        - `vmId` string — The ID of the VM.
      - `vmName` string — The name of the VM.
      - `vmManagerName` string — The name of the VM manager.
      - `vmManagerType` 'VSPHERE' | 'SCVMM' | 'HYPERV-MANAGER' — The type of VM management product.
      - `vmPath` string — The VM folder path in the vCenter Server virtual machine inventory tree.
    - `replicationJobId` string — The ID of the replication job.
    - `replicationJobTerminated` boolean — Indicates whether the replication job is deleted or failed.
  - `nextToken` string — The token required to retrieve the next set of results. This value is null when there are no more results to return.

## Other responses

- `480` — UnauthorizedOperationException
- `481` — InvalidParameterException
- `482` — MissingRequiredParameterException
- `483` — InternalError

---

[API](https://skmtc.net/aws/apis/sms.md) · [All operations](https://skmtc.net/aws/apis/sms/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/sms/versions/b93b64b4502e/schema)