批量设备离周期
接口描述
将设备从当前云备份周期移除。移除后设备云备份策略降回免费模式（固定 31 天滚动保留，无容量限制）。
请求说明
| 接口ID |
协议 |
方法 |
PATH |
| 77 |
HTTPS |
POST |
/openapi/v1/cbs/user/devices/leave |
PATH参数
无
URL参数
| 参数 |
类型 |
必填 |
说明 |
| accesskey_id |
string |
是 |
参见签名认证 |
| expires |
int |
是 |
参见签名认证 |
| signature |
string |
是 |
参见签名认证 |
HTTP请求头
| 字段 |
值 |
| Content-Type |
application/json |
请求参数
请求参数以Json格式放置于Body中，字段如下：
| 参数 |
类型 |
必填 |
说明 |
| sns |
string[] |
是 |
设备序列号列表，1-200 条，SN 格式见批量查询设备所属周期 |
请求示例
POST https://open.vzicloud.com/openapi/v1/cbs/user/devices/leave?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
Host: open.vzicloud.com
Content-Type: application/json
{
"sns": ["12345678-87654321"]
}
返回说明
返回参数
| 参数 |
类型 |
说明 |
| successes |
array |
成功的设备列表 |
| + sn |
string |
设备 SN |
| failures |
array |
失败的设备列表和原因 |
| + sn |
string |
设备 SN |
| + code |
int |
错误码 |
| + message |
string |
错误描述 |
返回示例
{
"successes": [
{ "sn": "12345678-87654321" }
],
"failures": [
{ "sn": "12345678-87654322", "code": 1005, "message": "设备未入周期" }
]
}