天翼云智能视图服务API

1. 绑定设备到存储模板

接口功能介绍

本接口用于批量绑定视图设备到指定视图存储模板，一次最多绑定50个设备。设备绑定到其他模板时，调用此接口会将设备绑定到新模板，原绑定关系解除。

接口约束

无

URI

POST /ga1400Templates/devices/bind

路径参数

无

Query参数

无

请求参数

请求头header参数

参数	是否必填	参数类型	说明	示例
Authorization	是	String	认证信息。	CT-HMAC-SHA256 Credential=FQ01GA2RR9IJFM1PWIPR/2023-07-18/vss, SignedHeaders=content-type;host;timestamp, Signature=c6e72dffcfb2d25d276e119781e1deb6656d966702191b2bd862d1691e39394f
Content-Type	是	String	互联网媒体类型。	application/json;charset=utf-8
Host	是	String	主机。	vssapi.ctyun.cn
Version	是	String	版本。	2021-11-25
Timestamp	是	String	时间戳。	1689643309

请求体body参数

参数	是否必填	参数类型	说明	示例	下级对象
Devices	是	Array of Objects	绑定设备id列表，一次最多绑定50个设备。		BindDevice
TemplateId	是	Integer	视图模板Id。

BindDevice

参数	是否必填	参数类型	说明	示例	下级对象
DeviceId	是	Integer	设备Id。	872220438072010736

响应参数

参数	参数类型	说明	示例	下级对象
statusCode	Integer	响应状态码。	200
error	String	错误码，执行成功时，不返回该字段。	VSS_0001
message	String	响应信息。	请求成功
requestId	String	请求ID。	362d4e78556b47129182d0881fade86b
returnObj	Object	响应数据，执行失败时，不返回该字段。		returnObj

表 returnObj

参数	参数类型	说明	示例	下级对象
RequestId	String	请求ID。	a194d4c32d4d4e489f70ac9296f46c72

请求示例

请求url

POST '/ga1400Templates/devices/bind'

请求头header

{
    "Authorization": "CT-HMAC-SHA256 Credential=SBGX5QWGRAC5QMDQUXIZ/2023-04-25/vss, SignedHeaders=content-type;host;timestamp, Signature=6c41c6674f3c6430a592f6e0ab3185fa752b895e6773c8bbf76b38e099e029fe",
    "Content-Type": "application/json;charset=utf-8",
    "Host": "vssapi.ctyun.cn",
    "Version": "2021-11-25",
    "Timestamp": "1682406354"
}

请求体body

{    
  "TemplateId": 1232723629073039123,
  "Devices": [
    {
      "DeviceId": "872220438072010736"
    }
  ]
}

响应示例

{
  "statusCode": 200,
  "message": "请求成功",
  "requestId": "a194d4c32d4d4e489f70ac9296f46c72",
  "returnObj": {
     "RequestId": "920844e56e6944e193da622fe222bcbc"
  }
}

状态码

请参考状态码说明。

错误码

请参考错误码说明。

绑定设备到存储模板

最近更新时间：2026-03-19 18:16:28