文档平台 API 中心 云硬盘 云硬盘 API 2017 云硬盘相关接口 查询云主机已挂载弹性云盘数量

查询云主机已挂载弹性云盘数量

最近更新时间:2017-12-12 17:58:31

1. 接口描述

本接口(DescribeInstancesCbsNum)用于查询云主机已挂载的弹性云盘数量和可挂载的弹性云盘的总数。

接口请求域名:cbs.api.qcloud.com

使用限制:

无特殊限制,具体参数限制见下表。

3. 输入参数

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

参数名称 必选 类型 描述
uInstanceIds Array[String] 云服务器实例ID,通过DescribeInstances(查看实例列表)接口查询

4. 输出参数

参数名称 类型 描述
code Int 公共错误码,0表示成功,其他值表示失败。详见错误码页面
message String 错误信息,详见错误码页面
detail Array[Object] 云服务器可挂载与最大可挂载弹性云盘数量。详情见下表

detail结构:

参数名称 类型 描述
count Int 当前云服务器已挂载弹性云盘数量
maxAttachNum String 当前云服务器最大可挂载弹性云盘数量

4. 错误码表

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

错误代码 英文描述 错误描述
9003 InvalidParameter 参数错误
9006 InternalError 服务器后台错误

5. 示例

输入

https://cbs.api.qcloud.com/v2/index.php?
<公共请求参数>
&Action=DescribeInstancesCbsNum
&uInstanceIds.0=ins-ka40hchw

输出

{
    "code":"0",
    "message":"",
    "detail":{
        "ins-ka40hchw":{
            "count":"5",
            "maxAttachNum":"10"
        }
    }
}

如果有其他疑问,你也可以通过提问形式与我们联系探讨