Skip to content

获取云盘基础信息 ​

获取当前用户的云盘基础信息,包括云盘空间总量、已使用量、到期时间、扩容包列表等。

接口地址:

text
/papi/file/cloudDisk

请求方式:

text
POST

Header 参数:

参数类型必填说明
X-Access-Keystring是API 访问密钥 ID,鉴权方式见 接口规则
X-Signaturestring是签名值,Base64 编码的 HMAC-SHA256 计算结果
X-Timestampstring是毫秒级 Unix 时间戳(13 位)
X-Noncestring是随机字符串,10~32 位小写字母+数字

Body 参数:

无请求体参数。

响应参数:

参数类型说明
codeinteger错误码,参见 错误码说明
dataobject返回数据
├─ cloudDiskinteger当前云盘空间
├─ cloudDiskUsedinteger已使用云盘空间
├─ cloudDiskExpireinteger云盘到期时间
├─ cloudDiskFreeinteger云盘免费空间大小
├─ cloudDiskExpireAmountinteger云盘 7 天内到期空间大小
├─ hasContainerboolean是否拥有云手机
├─ cloudDiskExpandListarray[object]云盘扩容包列表
├─├─ changeAmountinteger扩容包大小
├─├─ expirationTimeinteger扩容包过期时间
├─├─ skuCodestringSKU 编码
├─├─ packageCodestring套餐编码
├─├─ ExpiringFlagboolean是否即将到期
├─├─ expireTimeinteger订单的扩容包过期时间
msgstring错误提示

响应示例:

json
{
    "code": 0,
    "data": {
        "cloudDisk": 0,
        "cloudDiskUsed": 0,
        "cloudDiskExpire": 0,
        "cloudDiskFree": 0,
        "cloudDiskExpireAmount": 0,
        "hasContainer": false,
        "cloudDiskExpandList": [
            {
                "changeAmount": 0,
                "expirationTime": 0,
                "skuCode": "",
                "packageCode": "",
                "ExpiringFlag": false,
                "expireTime": 0
            }
        ]
    },
    "msg": ""
}

OpenAPI Docs