查询IPC列表
功能介绍
获取多个IPC资源
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v1/{project_id}/cameras
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
参数说明：项目ID。获取方法请参见“API参考 > 附录 > 获取项目ID”。 取值范围：仅支持数字，a到f的小写字母组合，长度32。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
offset |
否 |
Integer |
参数说明：分页查询时的页码。 最小值：0 最大值：1000 缺省值：0 |
limit |
否 |
Integer |
参数说明：分页查询时每页显示的记录数。 最小值：1 最大值：100 缺省值：10 |
status |
否 |
String |
参数说明：摄像机的状态。 取值范围：
枚举值：
|
v2x_edge_id |
否 |
String |
参数说明：Edge ID，用于唯一标识一个Edge，创建Edge后获得。 取值范围：长度36，只允许小写字母、数字、连接符（-）的组合。 |
esn |
否 |
String |
参数说明：IPC的设备编码。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
Instance-Id |
否 |
String |
参数说明：实例ID。DRIS物理实例的唯一标识，获取方法请参见“API参考 > 附录 > 获取Instance-Id”。 取值范围：仅支持数字，小写字母和横杠（-）的组合，长度36。 |
X-Auth-Token |
否 |
String |
参数说明：用户Token，Token认证鉴权时必选。通过调用IAM服务 “获取IAM用户Token”接口获取，接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。简要的获取方法样例请参见“API参考 > API > 应用侧API参考 > 如何调用API > 认证鉴权 > Token认证”。 最小长度：1 最大长度：20000 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
count |
Long |
参数说明：总数 最小值：0 最大值：2000 |
ipcs |
Array of IpcResponseDTO objects |
参数说明：IPC列表 数组长度：0 - 2147483647 |
参数 |
参数类型 |
描述 |
|---|---|---|
camera_id |
String |
参数说明：摄像头ID，console界面查询摄像头IPC列表中的设备Id。 最小长度：0 最大长度：255 |
v2x_edge_id |
String |
参数说明：Edge ID，用于唯一标识一个Edge，创建Edge后获得。 最小长度：0 最大长度：128 |
name |
String |
参数说明：摄像头名称。 最小长度：0 最大长度：255 |
cross_id |
String |
参数说明：摄像头所感知的路口或者路段的Id。 最小长度：0 最大长度：255 |
focal_type |
String |
参数说明：摄像头聚焦类型。
|
parent_connect_code |
String |
参数说明：摄像头连接的ITS800的互联编码。 最小长度：0 最大长度：128 |
connect_code |
String |
参数说明：摄像头的互联编码。 最小长度：0 最大长度：128 |
description |
String |
参数说明：描述。 最大长度：255 |
esn |
String |
参数说明：IPC的设备编码。 最大长度：64 |
ip |
String |
参数说明：该摄像头的ip地址。 最大长度：255 |
status |
String |
参数说明：摄像机的状态。 取值范围：
枚举值：
|
brief_type |
Integer |
参数说明：摄像头类型。
|
sequence_no |
Integer |
参数说明：摄像头编号,该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 最小值：0 最大值：128 |
direction |
Integer |
参数说明：道路检测方向，0表示朝向起点，1表示朝向终点,255表示无效值。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 最小值：0 最大值：255 |
lon |
Number |
参数说明：摄像头经度，。东经为正，西经为负，单位°，精度小数点后7位。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 最小值：-180 最大值：180 |
lat |
Number |
参数说明：摄像头纬度，北纬为正，南纬为负，单位°，精度小数点后7位。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 最小值：-90 最大值：90 |
sensor_angle |
Number |
参数说明：摄像头部署的角度，以正北为0，顺时针旋转（无线的部署方式）。该字段是SNE感知设备信息上报的，只有SNE会上报该字段。 最小值：-180 最大值：180 |
created_time |
String |
参数说明：创建时间。 格式：yyyy-MM-dd''T''HH:mm:ss''Z''。 例如 2020-09-01T01:37:01Z。 |
last_modified_time |
String |
参数说明：最后修改时间。 格式：yyyy-MM-dd''T''HH:mm:ss''Z''。 例如 2020-09-01T01:37:01Z。 |
last_online_time |
String |
参数说明：最后在线时间。 格式：yyyy-MM-dd''T''HH:mm:ss''Z''。 例如 2020-09-01T01:37:01Z。 |
请求示例
GET https://{endpoint}/v1/{project_id}/cameras?limit={limit}&status={status}&v2x_edge_id={v2x_edge_id}&offset={offset}
Content-Type:application/json
X-Auth-Token:********
Instance-Id:********
响应示例
状态码： 200
OK
{
"count" : 1,
"ipcs" : [ {
"camera_id" : "8f6a6e23-f245-412a-92b7-4c4944284418",
"v2x_edge_id" : "99678cc3-1665-4cc0-be01-b69346094542",
"name" : "camera2",
"cross_id" : "code",
"focal_type" : "long",
"parent_connect_code" : "connectcode",
"connect_code" : "code",
"description" : "test",
"esn" : "124546416113",
"ip" : "127.0.0.1",
"status" : "ONLINE",
"brief_type" : 101,
"sequence_no" : 1,
"direction" : 0,
"lon" : 114.0398513,
"lat" : 30.5087712,
"sensor_angle" : 124.711914,
"created_time" : "2021-12-23T12:59:43.935Z",
"last_modified_time" : "2021-12-23T12:59:43.935Z",
"last_online_time" : "2021-12-23T12:59:43.935Z"
} ]
}
状态码
状态码 |
描述 |
|---|---|
200 |
OK |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
405 |
Method Not Allowed |
409 |
Conflict |
429 |
Too Many Requests |
500 |
Internal Server Error |
错误码
请参见错误码。
