创建应用，发布应用版本方法参 见：更新应用版本状态。
1.1.10 Edge 管理
1.1.10.1 查询 Edge 列表 功能介绍功能介绍
状态码
状态码 描述
204 No Content 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found
405 Method Not Allowed 409 Conflict
429 Too Many Requests 500 Internal Server Error
错误码
请参见错误码。
1.1.10 Edge 管理
1.1.10.1 查询 Edge 列表 功能介绍
查询Edge列表
URI
GET /v1/{project_id}/v2x-edges
表1-139 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 参数说明：项目ID。获取方法请 参见 获取项目ID。
取值范围：仅支持数字，a到f的 小写字母组合，长度32。
正则匹配：^[0-9a-f]{32}$
表1-140 Query 参数
参数 是否必选 参数类型 描述
offset 否 Integer 参数说明：分页查询时的页码，
offset大于等于0，默认取值为 0。
最小值：0 最大值：20 缺省值：0
limit 否 Integer 参数说明：分页查询时每页显示
的记录数，默认值为10，取值 范围为0-20的整数。
最小值：0 最大值：20 缺省值：10
status 否 String 参数说明：状态。
取值范围：
● UNINSTALLED： 待部署
● INSTALLED：部署中
● OFFLINE：离线
● ONLINE：在线：
● UPGRADING：升级中
● DELETING：删除中 正则匹配：(UNINSTALLED|
INSTALLED|OFFLINE|ONLINE|
UPGRADING|DELETING)
请求参数
表1-141 请求 Header 参数
参数 是否必选 参数类型 描述
Instance-Id 否 String 参数说明：实例ID。dris物理实 例的唯一标识。获取方法参见获
取Instance-Id。
取值范围：仅支持数字，小写字 母和横杠（-）的组合，长度 36。
参数 是否必选 参数类型 描述
X-Auth-Token 否 String 参数说明：用户Token，Token 认证鉴权时必选。通过调用IAM 服务 获取IAM用户Token接口 获取，接口返回的响应消息头中
“X-Subject-Token”就是需要 获取的用户Token。简要的获取 方法样例请参见 Token认证。
最小长度：1 最大长度：20000
响应参数
状态码： 200
表1-142 响应 Body 参数
参数 参数类型 描述
count Long 参数说明：总数。
最小值：0
最大值：2147483647 edges Array of
V2XEdgeList ResponseDT O objects
参数说明：数据列表。
表1-143 V2XEdgeListResponseDTO
参数 参数类型 描述
v2x_edge_id String 参数说明：Edge ID，用于唯一标识一个Edge。
最小长度：0 最大长度：255
name String 参数说明：V2XEdge的名称
取值范围：长度不超过128，只允许中文、字 母、数字、以及_.-等字符的组合。
最大长度：128
正则匹配：^[-a-zA-Z0-9_\u4e00-\u9fa5]
{1,128}$
参数 参数类型 描述
esn String 参数说明：设备编码。
取值范围：长度不超过64，只允许字母、数字、
以及_等字符的组合。
正则匹配：^[a-zA-Z0-9_]{1,64}$
position_descr
iption String 参数说明：安装位置编码，由用户自定义。
取值范围：长度不低于1不超过128，只允许字 母、数字、下划线（_）的组合。
正则匹配：^[a-zA-Z0-9_]{1,128}$
location Location
object 经纬度坐标 status String 参数说明：状态。
取值范围：
● UNINSTALLED： 待部署
● INSTALLED：部署中
● OFFLINE：离线
● ONLINE：在线：
● UPGRADING：升级中
● DELETING：删除中
正则匹配：(UNINSTALLED|INSTALLED|OFFLINE|
ONLINE|UPGRADING|DELETING) channel_statu
s String 参数说明：业务通道状态。
枚举值：
● ONLINE
● OFFLINE
● UNKNOWN created_time String 参数说明：创建时间。
格式：yyyy-MM-dd''T''HH:mm:ss''Z''。
例如 2020-09-01T01:37:01Z。
表1-144 Location
参数 参数类型 描述
lat Number 参数说明：定义纬度数值，北纬为正，南纬为
参数 参数类型 描述
lon Number 参数说明：定义经度数值。东经为正，西经为 负。单位°，精度小数点后7位。
最小值：-180 最大值：180
请求示例
GET https://{endpoint}/v1/{project_id}/v2x-edges?limit={limit}&offset={offset}&status={status}
Content-Type:application/json X-Auth-Token:********
Instance-Id:********
响应示例
状态码： 200 OK
{ "count" : 1, "edges" : [ {
"v2x_edge_id" : "74297d76-6f99-4fe2-a435-1e27a524e4c8", "name" : "name",
"esn" : "ESN0001123234", "position_description" : "test", "status" : "ONLINE",
"channel_status" : "ONLINE",
"created_time" : "2020-09-01T01:37:01Z"
} ] }
状态码
状态码 描述
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
错误码
请参见错误码。