UpdateLaunchConfiguration - AWS Elastic Disaster Recovery

UpdateLaunchConfiguration

Updates a LaunchConfiguration by Source Server ID.

Request Syntax

POST /UpdateLaunchConfiguration HTTP/1.1 Content-type: application/json { "copyPrivateIp": boolean, "copyTags": boolean, "launchDisposition": "string", "launchIntoInstanceProperties": { "launchIntoEC2InstanceID": "string" }, "licensing": { "osByol": boolean }, "name": "string", "postLaunchEnabled": boolean, "sourceServerID": "string", "targetInstanceTypeRightSizingMethod": "string" }

URI Request Parameters

The request does not use any URI parameters.

Request Body

The request accepts the following data in JSON format.

copyPrivateIp

Whether we should copy the Private IP of the Source Server to the Recovery Instance.

Type: Boolean

Required: No

copyTags

Whether we want to copy the tags of the Source Server to the EC2 machine of the Recovery Instance.

Type: Boolean

Required: No

launchDisposition

The state of the Recovery Instance in EC2 after the recovery operation.

Type: String

Valid Values: STOPPED | STARTED

Required: No

launchIntoInstanceProperties

Launch into existing instance properties.

Type: LaunchIntoInstanceProperties object

Required: No

licensing

The licensing configuration to be used for this launch configuration.

Type: Licensing object

Required: No

name

The name of the launch configuration.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 128.

Required: No

postLaunchEnabled

Whether we want to enable post-launch actions for the Source Server.

Type: Boolean

Required: No

sourceServerID

The ID of the Source Server that we want to retrieve a Launch Configuration for.

Type: String

Length Constraints: Fixed length of 19.

Pattern: ^s-[0-9a-zA-Z]{17}$

Required: Yes

targetInstanceTypeRightSizingMethod

Whether Elastic Disaster Recovery should try to automatically choose the instance type that best matches the OS, CPU, and RAM of your Source Server.

Type: String

Valid Values: NONE | BASIC | IN_AWS

Required: No

Response Syntax

HTTP/1.1 200 Content-type: application/json { "copyPrivateIp": boolean, "copyTags": boolean, "ec2LaunchTemplateID": "string", "launchDisposition": "string", "launchIntoInstanceProperties": { "launchIntoEC2InstanceID": "string" }, "licensing": { "osByol": boolean }, "name": "string", "postLaunchEnabled": boolean, "sourceServerID": "string", "targetInstanceTypeRightSizingMethod": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

copyPrivateIp

Whether we should copy the Private IP of the Source Server to the Recovery Instance.

Type: Boolean

copyTags

Whether we want to copy the tags of the Source Server to the EC2 machine of the Recovery Instance.

Type: Boolean

ec2LaunchTemplateID

The EC2 launch template ID of this launch configuration.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 256.

launchDisposition

The state of the Recovery Instance in EC2 after the recovery operation.

Type: String

Valid Values: STOPPED | STARTED

launchIntoInstanceProperties

Launch into existing instance properties.

Type: LaunchIntoInstanceProperties object

licensing

The licensing configuration to be used for this launch configuration.

Type: Licensing object

name

The name of the launch configuration.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 128.

postLaunchEnabled

Whether we want to activate post-launch actions for the Source Server.

Type: Boolean

sourceServerID

The ID of the Source Server for this launch configuration.

Type: String

Length Constraints: Fixed length of 19.

Pattern: ^s-[0-9a-zA-Z]{17}$

targetInstanceTypeRightSizingMethod

Whether Elastic Disaster Recovery should try to automatically choose the instance type that best matches the OS, CPU, and RAM of your Source Server.

Type: String

Valid Values: NONE | BASIC | IN_AWS

Errors

For information about the errors that are common to all actions, see Common Errors.

ConflictException

The request could not be completed due to a conflict with the current state of the target resource.

HTTP Status Code: 409

InternalServerException

The request processing has failed because of an unknown error, exception or failure.

HTTP Status Code: 500

ResourceNotFoundException

The resource for this operation was not found.

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 429

UninitializedAccountException

The account performing the request has not been initialized.

HTTP Status Code: 400

ValidationException

The input fails to satisfy the constraints specified by the AWS service.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: