功能介绍
默认接口请求频率限制：500次/秒。
查询与资源包绑定的设备列表。
接口约束
查询前确保该资源包存在。
URL
GET /v1?
请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeAttachedDevices | 操作接口名，系统规定参数。 |
| ResourceId | String | 是 | bc303cb2dbdf4b46bc55f455ed1262c6 | 资源ID |
| DeviceName | String | 否 | 111 | 设备名称 |
| PageNum | Long | 否 | 1 | 第几个分页，默认为1。 |
| PageSize | Long | 否 | 20 | 分页大小，默认为20。取值范围为1～1000 |
返回参数
| 参数 | 类型 | 描述 |
|---|---|---|
| PageNum | Long | 第几个分页。 |
| PageSize | Long | 分页大小。 |
| TotalPage | Long | 分页总数。 |
| TotalNum | Long | 设备总数。 |
| Devices | Device[] | 设备列表。 |
| RequestId | String | 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
Device
| 参数 | 类型 | 描述 |
|---|---|---|
| DeviceId | String | 设备ID |
| InProtocol | String | 协议类型。取值：gb28181, rtmp, onvif, rtsp, ehome。 |
| DeviceType | String | 设备类型。取值：ipc, nvr, platform。 |
| DeviceName | String | 设备名称 |
| ResourceType | String | 资源类型 |
| Status | String | 资源状态 |
| GbId | String | 国标ID |
| CreateTime | String | 创建时间 |
| DeviceVendor | String | 设备厂商 |
示例
请求示例
GET https://vss-dsp-gzgy2-a.ctapi.ctyun.cn/v1?Action=DescribeAttachedDevices&DeviceName=%E5%B7%B2%E5%AD%98%E5%9C%A8%E7%9A%84ipc&PageNum=1&PageSize=20&ResourceId=resource01_video_234test001
Connection: keep-alive
ctyun-eop-request-id: d3fea38f-c81e-406a-a82e-032c1efdc599
Eop-date: 20221025T094826Z
Eop-Authorization: BLLOJSUVKOZ7RVV9VEFF Headers=ctyun-eop-request-id;eop-date Signature=x86XEK1daHdnc3UrnZEWlSO6P78eqzBD7drOV5L8Szs=
Host: vss-dsp-gzgy1-a.ctapi-test.ctyun.cn
User-Agent: Apache-HttpClient/4.5.13
返回示例
{
"PageNum": 1,
"PageSize": 20,
"TotalPage": 1,
"TotalNum": 2,
"Devices": [
{
"DeviceId": "29942054192679615",
"DeviceName": "已存在的ipc",
"DirPath": "",
"DeviceType": "ipc",
"ResourceType": "VSS_VIDEO",
"Status": "0",
"DeviceVendor": "海康",
"GbId": "51030300101327001909",
"CreateTime": "2022-09-21 14:25:11",
"Inprotocol": "gb28181",
"Idpath": ""
},
{
"DeviceId": "29941916753726912",
"DeviceName": "已存在的ipc",
"DirPath": "",
"DeviceType": "ipc",
"ResourceType": "VSS_VIDEO",
"Status": "0",
"DeviceVendor": "海康",
"GbId": "51030300401327000005",
"CreateTime": "2022-09-22 11:42:46",
"Inprotocol": "gb28181",
"Idpath": ""
}
],
"RequestId": "b30f9ff015ab436c9a39d0222d01448f"
}
