有奖捉虫:云通信与企业服务文档专题,速来> HOT

1. 接口描述

本接口(DetachCbsStorages)用于解挂指定的弹性云盘。

接口调用域名:cbs.api.qcloud.com

使用限制:

  1. 只支持弹性云盘。云硬盘类型可以通过DescribeCbsStorages(查询云硬盘信息)接口查询,见输出参数中portable字段解释。
  2. 云硬盘必须处于已挂载状态,且状态为normal。云硬盘挂载状态可以通过DescribeCbsStorages(查询云硬盘信息)接口查询,见输出参数中storageStatusattached字段解释。

2. 输入参数

以下请求参数列表仅列出了接口请求参数,其它参数见公共请求参数页面。

参数名称 必选 类型 描述
storageIds Array[String] 将要解挂的云硬盘ID, 通过DescribeCbsStorages(查询云硬盘信息)接口查询,单次请求最多可操作10块弹性云盘

3. 输出参数

参数名称 类型 描述
code Int 公共错误码,0表示成功,其他值表示失败。详见错误码页面
message String 错误信息,详见错误码页面
detail Array[object] 批量异步任务接口返回格式

4. 错误码表

以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见云硬盘错误码

错误代码 英文描述 错误描述
9003 InvalidParameter 参数错误
16007 IncorrectInstanceStatus.DiskTypeInvalid 当前云硬盘不支持此操作
16008 IncorrectInstanceStatus.OnlySupportElasticCloudDisk 只能解挂弹性云盘
9033 InvalidInstanceId.CvmNotFound 云服务器不存在
9814 IncorrectInstanceStatus.CvmStatusInvalid 云服务器状态不满足
9008 OperationDenied.PermissionDenied 没有权限

5. 示例

输入

https://cbs.api.qcloud.com/v2/index.php?
<公共请求参数>
&Action=DetachCbsStorages
&storageIds.0=disk-123bdkvd
&storageIds.1=disk-a2dbffgk

输出

{
    "code":"0",
    "message":"",
    "detail":{
        "disk-123bdkvd":{
            "code":"16000",
            "message":"disk not exist"
        },
        "disk-a2dbffgk":{
            "code":"0",
            "message":"ok"
        }
    }
}