批量设备入周期
接口描述
将设备批量关联到指定生命周期（加入云备份周期）。若设备尚未开启云备份，会自动开启；开启后设备将按目标生命周期的策略上传数据。
请求说明
| 接口ID |
协议 |
方法 |
PATH |
| 76 |
HTTPS |
POST |
/openapi/v1/cbs/user/devices/join |
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/join?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
Host: open.vzicloud.com
Content-Type: application/json
{
"sns": ["12345678-87654321"],
"lifecycle_id": 2001
}
返回说明
返回参数
| 参数 |
类型 |
说明 |
| successes |
array |
成功的设备列表 |
| + sn |
string |
设备 SN |
| failures |
array |
失败的设备列表和原因 |
| + sn |
string |
设备 SN |
| + code |
int |
错误码 |
| + message |
string |
错误描述 |
返回示例
{
"successes": [
{ "sn": "12345678-87654321" }
],
"failures": [
{ "sn": "12345678-87654322", "code": 1003, "message": "无权访问该设备" }
]
}