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

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

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

Creates or updates the launch configuration for the specified application.

## Headers

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

## Request body

- PutAppLaunchConfigurationRequest
  - `appId` string — The ID of the application.
  - `roleName` string — The name of service role in the customer's account that CloudFormation uses to launch the application.
  - `autoLaunch` boolean — Indicates whether the application is configured to launch automatically after replication is complete.
  - `serverGroupLaunchConfigurations` ServerGroupLaunchConfiguration[] — Information about the launch configurations for server groups in the application.
    - `serverGroupId` string — The ID of the server group with which the launch configuration is associated.
    - `launchOrder` integer — The launch order of servers in the server group.
    - `serverLaunchConfigurations` ServerLaunchConfiguration[] — The launch configuration for servers in the server group.
      - `server` object — The ID of the server with which the launch configuration is associated.
        - `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.
      - `logicalId` string — The logical ID of the server in the CloudFormation template.
      - `vpc` string — The ID of the VPC into which the server should be launched.
      - `subnet` string — The ID of the subnet the server should be launched into.
      - `securityGroup` string — The ID of the security group that applies to the launched server.
      - `ec2KeyName` string — The name of the Amazon EC2 SSH key to be used for connecting to the launched server.
      - `userData` object — Location of the user-data script to be executed when launching the server.
        - `s3Location` object — Amazon S3 location of the user-data script.
          - `bucket` string — The Amazon S3 bucket name.
          - `key` string — The Amazon S3 bucket key.
      - `instanceType` string — The instance type to use when launching the server.
      - `associatePublicIpAddress` boolean — Indicates whether a publicly accessible IP address is created when launching the server.
      - `iamInstanceProfileName` string — The name of the IAM instance profile.
      - `configureScript` S3Location — Location of an Amazon S3 object.
        - `bucket` string — The Amazon S3 bucket name.
        - `key` string — The Amazon S3 bucket key.
      - `configureScriptType` 'SHELL_SCRIPT' | 'POWERSHELL_SCRIPT' — The type of configuration script.

## Response `200`

Success

- PutAppLaunchConfigurationResponse

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