批量设备转移周期
接口描述
将设备从当前生命周期转移到新的目标生命周期，等同于先离周期再加入新生命周期。若设备尚未开启云备份，会自动开启。
请求说明
| 接口ID |
协议 |
方法 |
PATH |
| 78 |
HTTPS |
POST |
/openapi/v1/cbs/user/devices/move |
PATH参数
无
URL参数
| 参数 |
类型 |
必填 |
说明 |
| accesskey_id |
string |
是 |
参见签名认证 |
| expires |
int |
是 |
参见签名认证 |
| signature |
string |
是 |
参见签名认证 |
HTTP请求头
| 字段 |
值 |
| Content-Type |
application/json |
请求参数
请求参数以Json格式放置于Body中，字段如下：
| 参数 |
类型 |
必填 |
说明 |
| sns |
string[] |
是 |
设备序列号列表，1-200 条，SN 格式见批量查询设备所属周期 |
| lifecycle_id |
int |
是 |
目标生命周期 ID（需属于当前公司周期） |
请求示例
POST https://open.vzicloud.com/openapi/v1/cbs/user/devices/move?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
Host: open.vzicloud.com
Content-Type: application/json
{
"sns": ["12345678-87654321"],
"lifecycle_id": 2002
}
返回说明
返回参数
| 参数 |
类型 |
说明 |
| successes |
array |
成功的设备列表 |
| + sn |
string |
设备 SN |
| failures |
array |
失败的设备列表和原因 |
| + sn |
string |
设备 SN |
| + code |
int |
错误码 |
| + message |
string |
错误描述 |
返回示例
{
"successes": [
{ "sn": "12345678-87654321" }
],
"failures": []
}