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

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

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

Retrieve information about the specified application.

## Headers

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

## Request body

- GetAppRequest
  - `appId` string — The ID of the application.

## Response `200`

Success

- GetAppResponse
  - `appSummary` object — Information about the application.
    - `appId` string — The unique ID of the application.
    - `importedAppId` string — The ID of the application.
    - `name` string — The name of the application.
    - `description` string — The description of the application.
    - `status` 'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING' | 'DELETED' | 'DELETE_FAILED' — Status of the application.
    - `statusMessage` string — A message related to the status of the application
    - `replicationConfigurationStatus` 'NOT_CONFIGURED' | 'CONFIGURED' — Status of the replication configuration.
    - `replicationStatus` 'READY_FOR_CONFIGURATION' | 'CONFIGURATION_IN_PROGRESS' | 'CONFIGURATION_INVALID' | 'READY_FOR_REPLICATION' | 'VALIDATION_IN_PROGRESS' | 'REPLICATION_PENDING' | 'REPLICATION_IN_PROGRESS' | 'REPLICATED' | 'PARTIALLY_REPLICATED' | 'DELTA_REPLICATION_IN_PROGRESS' | 'DELTA_REPLICATED' | 'DELTA_REPLICATION_FAILED' | 'REPLICATION_FAILED' | 'REPLICATION_STOPPING' | 'REPLICATION_STOP_FAILED' | 'REPLICATION_STOPPED' — The replication status of the application.
    - `replicationStatusMessage` string — A message related to the replication status of the application.
    - `latestReplicationTime` string, date-time — The timestamp of the application's most recent successful replication.
    - `launchConfigurationStatus` 'NOT_CONFIGURED' | 'CONFIGURED' — Status of the launch configuration.
    - `launchStatus` 'READY_FOR_CONFIGURATION' | 'CONFIGURATION_IN_PROGRESS' | 'CONFIGURATION_INVALID' | 'READY_FOR_LAUNCH' | 'VALIDATION_IN_PROGRESS' | 'LAUNCH_PENDING' | 'LAUNCH_IN_PROGRESS' | 'LAUNCHED' | 'PARTIALLY_LAUNCHED' | 'DELTA_LAUNCH_IN_PROGRESS' | 'DELTA_LAUNCH_FAILED' | 'LAUNCH_FAILED' | 'TERMINATE_IN_PROGRESS' | 'TERMINATE_FAILED' | 'TERMINATED' — The launch status of the application.
    - `launchStatusMessage` string — A message related to the launch status of the application.
    - `launchDetails` object — Details about the latest launch of the application.
      - `latestLaunchTime` string, date-time — The latest time that this application was launched successfully.
      - `stackName` string — The name of the latest stack launched for this application.
      - `stackId` string — The ID of the latest stack launched for this application.
    - `creationTime` string, date-time — The creation time of the application.
    - `lastModified` string, date-time — The last modified time of the application.
    - `roleName` string — The name of the service role in the customer's account used by Server Migration Service.
    - `totalServerGroups` integer — The number of server groups present in the application.
    - `totalServers` integer — The number of servers present in the application.
  - `serverGroups` ServerGroup[] — The server groups that belong to the application.
    - `serverGroupId` string — The ID of a server group.
    - `name` string — The name of a server group.
    - `serverList` Server[] — The servers that belong to a server group.
      - `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.
  - `tags` Tag[] — The tags associated with the application.
    - `key` string — The tag key.
    - `value` string — The tag value.

## Other responses

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

---

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