查询包周期或按需资源下的通道列表
功能介绍
用户查询包周期或按需资源下的通道列表
URI
GET /v1/{user_id}/resources/{resource_id}/channels
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
resource_id |
是 |
String |
包周期资源ID:32位数字、字母组成 |
user_id |
是 |
String |
用户ID:由数字组成,长度范围[15,25],获取方式参考获取user ID与下载AK/SK章节 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
limit |
否 |
Integer |
单页内显示记录数:取值范围为[1,300],不填时默认值为10 |
offset |
否 |
Integer |
偏移量:取值范围为[0,2142147483646] |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Access-Token |
是 |
String |
用户认证AccessToken:从获取用户北向接口认证AccessToken中获取 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
channels |
Array of ChannelInfo objects |
通道列表 |
resource_type_code |
String |
资源类型编码
|
resource_name |
String |
资源名称 |
resource_id |
String |
资源ID |
resource_state |
String |
资源状态
|
mode |
String |
按需或包周期
|
total |
Integer |
通道总数 |
invalid_num |
Integer |
非法通道数 |
manage_num |
Integer |
管理通道数 |
参数 |
参数类型 |
描述 |
---|---|---|
attrs |
Array of AttributeInfo objects |
资源属性 |
device_name |
String |
设备名称 |
device_id |
String |
设备id |
channel_id |
String |
通道id |
channel_state |
String |
通道状态:
|
channel_name |
String |
通道名称,长度取值范围[1,64]个字符 |
bind_state |
String |
绑定状态 |
请求示例
GET /v1/7864512589745854564*****/resources/c0d3c9f9b70b4c3599fe4a98e*******/channels?offset=0&limit=2
响应示例
状态码: 200
{ "channels": [ { "attrs": [ { "attr_code": "storage_day", "attr_value": 90 } ], "device_name": "HoloSens IPC", "device_id": "testwl000***", "channel_id": "0", "channel_state": "OFFLINE", "channel_name": "HoloSens IPC", "bind_state": "NORMAL" }, { "attrs": [ { "attr_code": "storage_day", "attr_value": 90 } ], "device_name": "HoloSens SDC-test2", "device_id": "210123456SMY***", "channel_id": "0", "channel_state": "OFFLINE", "channel_name": "HoloSens SDC-test2", "bind_state": "NORMAL" } ], "resource_type_code": "NORMAL", "resource_name": "90天连续云存储月套餐", "resource_id": "321456789012345678901234567*****", "resource_state": "NORMAL", "mode": "PACKAGE", "total": 12, "invalid_num": 0, "manage_num": 0 }
状态码
请参见状态码
错误码
请参见错误码。