Start an instance

Last Updated: Jul 25, 2017

Description

When starting a specified instance, consider the following:

  • After the interface is invoked successfully, the specified instance will be in Starting status.
  • This interface can be invoked only when the instance is in Stopped status.
  • If OperationLocks of the instance indicates LockReason: security, the instance cannot be started.

Request parameters

Name Type Required Description
Action String Yes Value: StartInstance.
InstanceId String Yes ID of the instance to be started.

Return parameters

All parameters are public return parameters. For details, refer to Public Return Parameters.

Error code

Error Code Description Http status code Meaning
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 The specified InstanceId does not exist.
MissingParameter The input parameter InstanceId that is mandatory for processing this request is not supplied. 400 InstanceId value is missing.
IncorrectInstanceStatus The current state of the instance does not support this operation. 403 The current state of the instance does not support this operation.
InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons. 403 Operation is denied because the resource is locked for security reasons.
InsufficientBalance Your account does not have enough balance. 403 The instance cannot be started because the account does not have enough balance.
InternalError The request processing has failed due to some unknown error. 500 Internal error
InstanceNotReady The specified instance is not ready for use 403 The specified instance is being created.
DiskError IncorrectDiskStatus 403 Abnormal disk status.

Examples

Request example

  1. https://ecs.aliyuncs.com/?Action=StartInstance
  2. &InstanceId=i-instance1
  3. &<Public Request Parameters>

Return example

XML format

  1. <StartInstanceResponse>
  2. <RequestId>C0003E8B-B930-4F59-ADC0-0E209A9012A8</RequestId>
  3. </StartInstanceResponse>

JSON format

  1. {
  2. "RequestId": "C0003E8B-B930-4F59-ADC0-0E209A9012A8"
  3. }
Thank you! We've received your feedback.