API文档
云服务器相关接口
实例相关接口
启动云服务器

1. 启动云服务器

本接口用于启动一台云服务器。

  1. 只有状态为 Stopped 的云服务器才可以进行此操作。
  2. 启动云服务器成功后,云服务器会进入到 Running 状态。
  3. 本接口暂不支持批量开机操作,只能每次启动一个云服务器。
  4. 本接口为异步接口。当创建云服务器请求下发成功后会返回一个任务进度信息(jobUuid)。通过 jobUuid 可以查询出当前异步任务执行情况。如果异步任务正在执行,返回的内容里 done=false、success=false,并有进度值显示;如果异步任务执行成功完成,返回的内容里 done=true、success=true;如果异步任务执行失败,返回的内容里 done=true,success=false。

1.1. 接口说明

本接口所属服务类型为 ecs

本接口操作类型为 StartInstances

1.1.1. 请求路径

POST {baseUrl}/v3/ecs/StartInstances

1.1.2. 请求体

{
  "zoneCode": "cn-zhongwei-a",
  "ecsUuids": ["1d393df7-5ef0-4123-bf44-d2f953efae5e"]
}

请求体内容说明

属性名属性类型是否必须默认值说明
zoneCodeString可用区编码
ecsUuidsList<String>云服务器 UUID 列表

1.1.3. 返回内容

{
  "code": 200,
  "message": "开机成功",
  "data": [
    {
      "jobUuid": "70198ae61cf745e1848f255bfaf95c52",
      "success": false,
      "progress": 0.0,
      "type": "StartECS",
      "done": false,
      "resourceUuid": "1d393df7-5ef0-4123-bf44-d2f953efae5e"
    }
  ]
}

返回内容说明

属性名属性类型说明
codeInteger返回码。正常返回 200,异常返回500或其他业务错误码
messageString返回信息
dataArray异步任务进度信息

异步任务进度信息

属性名属性类型说明
jobUuidString异步任务唯一编码
successBoolean异步任务是否执行成功
progressDouble异步任务执行进度。0-100%
typeString异步任务类型
doneBoolean异步任务是否执行完成
resourceUuidString异步任务所处理的资源 Uuid

异步任务执行状态请详见异步任务.