轻量型云主机新建云硬盘

接口功能介绍

该接口提供用户轻量型云主机新建云硬盘的能力
  1. 云硬盘购买完成后自动挂载至轻量型云主机
  2. 数据盘到期日与所挂载的实例一致
  3. 实例和数据盘必须一起续费，无法单独为实例或数据盘续费
  4. 若数据盘所属轻量型云主机已开启自动续费，则数据盘默认开启自动续费
  5. 云硬盘计费方式：包年包月

准备工作：
  构造请求：在调用前需要了解如何构造请求，详情查看构造请求
  认证鉴权：openapi请求需要进行加密调用，详细查看认证鉴权
  计费模式：确认开通云主机的计费模式及计费项，详细查看计费方式及计费项
  产品选型：购买轻量型云主机前，请先阅读实例套餐了解轻量型云主机的规格套餐，并通过查询轻量型云主机的规格套餐资源接口，获取当前资源池可用轻量型云主机规格信息
注意事项：
  成本估算：了解云主机的计费项，详细查看价格总览进行成本估算
  用户配额：确认个人在不同资源池下资源配额，可以通过用户配额查询接口进行查询
  异步接口：该接口为异步接口，下单成功不代表业务成功。

接口约束

  1. 确保当前请求资源池下，该轻量型云主机存在（即instanceID真实存在且与regionID相对应）
  2. 云主机需要处于运行中（running）或关机（stopped）状态，您可以调用查询轻量型云主机详情查询结果中的instanceStatus字段来确认当前云主机状态

URI

POST /v4/ecs/lite/create-volume

路径参数

无

Query参数

无

请求参数

请求头header参数

无

请求体body参数

响应参数

表 returnObj

请求示例

请求头header

无

请求体body

{
    "regionID": "bb9fdb42056f11eda1610242ac110002",
    "clientToken": "lite-ecs-create-vol-test01",
    "instanceID": "adc614e0-e838-d73f-0618-a6d51d09070a",
    "diskType": "SATA",
    "diskSize": 10,
    "diskName": "att-test",
    "diskCount": 2
}

响应示例

{
    "returnObj": {
        "regionID": "aaf589124d5d11eaa04d0242ac110002",
        "masterOrderID": "107e901c449611ed8b6a0242ac110002",
        "masterOrderNO": "20221009163836430197"
    },
    "message": "SUCCESS",
    "description": "成功",
    "statusCode": 800
}

状态码

错误码