Skip to main content

StartInstance

Description

call StartInstance to start an ECS instance, and the instance enters the startup state after the interface call is successful.

Request Method

POST

Request Path

/apsara/route/Ecs/StartInstance

Request Parameters Common Parameters

NameLocationTypeRequiredSample valueDescription
InitLocalDiskBODYbooleanNotrueis applicable to instances including local disks such as instance specification family d1 or i2. When the local disk of d1 or i2 fails, you can use this parameter to specify whether the instance will be restored to its original healthy state when starting the instance. Value range: true: restore the instance to its original healthy state, and the data in the original local disk of the instance will be lost. false (default): do not do any processing, maintain the status quo.
InstanceIdBODYstringYesi-bp67acfmxazb4p****specifies the instance ID to start.
regionIdBODYstringYesNo sample value for this parameter.region id
DryRunBODYbooleanNotruewhether to precheck only this request. Value range: true: only the request is checked and the instance is not started. Check items include whether the AccessKey is valid, the authorization status of RAM users, and whether required parameters are filled in. If the check fails, the corresponding error is returned. If the check passes, the error code DryRunOperation will be returned. false (default): sends a normal request. after the request passes the check, it returns the 2XX HTTP status code and starts the instance directly.
versionBODYstringNo2016-01-01version of api

Return data

NameTypeSample valueDescription
RequestIDstring1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DCRequest id

Example

Successful Response example

{
"RequestID":"1E3D5A1E0-67CA-43DA-24BC-EAF2D5A1E4DC"
}

Failed Response example

{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}

}