创建应用，发布应用版本方法参 见：更新应用版本状态。
1.1.10 Edge 管理
1.1.10.2 创建 Edge
功能介绍
创建Edge
URI
POST /v1/{project_id}/v2x-edges
表1-145 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 参数说明：项目ID。获取方法请 参见 获取项目ID。
取值范围：仅支持数字，a到f的 小写字母组合，长度32。
正则匹配：^[0-9a-f]{32}$
请求参数
表1-146 请求 Header 参数
参数 是否必选 参数类型 描述
Instance-Id 否 String 参数说明：实例ID。dris物理实 例的唯一标识。获取方法参见获
取Instance-Id。
取值范围：仅支持数字，小写字 母和横杠（-）的组合，长度 36。
正则匹配：^[a-z0-9-]{36}$
X-Auth-Token 否 String 参数说明：用户Token，Token 认证鉴权时必选。通过调用IAM 服务 获取IAM用户Token接口 获取，接口返回的响应消息头中
“X-Subject-Token”就是需要 获取的用户Token。简要的获取
表1-147 请求 Body 参数
description 否 String 参数说明：Edge描述。
最大长度：255
port 否 Integer 参数说明：ITS800,ATLAS 端口 号。
最小值：0 最大值：65535 hardwareType 否 String 参数说明：硬件类型。
取值范围：ITS800 或者 ATLAS 正则匹配：(ITS800|ATLAS) position_descr
iption 否 String 参数说明：安装位置编码，由用
户自定义。
location 否 Location
object 参数说明：经纬度坐标。
参数 是否必选 参数类型 描述 camera_ids 否 Array of
strings 参数说明：摄像头ID列表。
最小长度：0 最大长度：255 radar_ids 否 Array of
strings 参数说明：雷达ID列表。
最小长度：0 最大长度：255 local_rsus 否 Array of
strings 参数说明：Edge关联的本地 RSU列表。
最大长度：255 edge_general
_config 否 EdgeGeneral
Config object 参数说明：Edge通用配置。
edge_advance
_config 否 Object 参数说明：Edge高级配置（请 谨慎修改，错误配置将导致
表1-148 Location
参数 是否必选 参数类型 描述
参数 是否必选 参数类型 描述
rsm_enabled 否 Boolean 参数说明：RSM上报：默认不上 报。
time_compen
sate 否 Boolean 参数说明：时延补偿：是否启动
Edge时延补偿功能。
rsi_positionin
g_enabled 否 Boolean 参数说明：RSI事件定位功能。
log_level 否 String 参数说明：应用日志级别，可选 项：on/off，默认关闭。
缺省值：off 正则匹配：(on|off)
user_name 否 String 参数说明：ITS800鉴权用的用户 名和密码。
最小长度：0 最大长度：255
password 否 String 参数说明：密码。
最小长度：0 最大长度：255
响应参数
状态码： 201
表1-150 响应 Body 参数
参数 参数类型 描述
v2x_edge_id String 参数说明：Edge ID，用于唯一标识一个Edge 最小长度：0
最大长度：255
name String 参数说明：名称。
取值范围：长度不低于1不超过128，只允许中 文、字母、数字、下划线（_）、连接符（-）的 组合。
正则匹配：^[-a-zA-Z0-9_\u4e00-\u9fa5]
{1,128}$
参数 参数类型 描述
description String 参数说明：Edge描述。
取值范围：长度不超过255，只允许中文、字
esn String 参数说明：设备编码。
取值范围：长度不超过64，只允许字母、数字、
以及_等字符的组合。
正则匹配：^[a-zA-Z0-9_]{1,64}$
ip String 参数说明：网络IP，例如127.0.0.1。
正则匹配：(^$|^((0|1\d?\d?|2[0-4]?\d?|
25[0-5]?|[3-9]\d?)\.){3}(0|1\d?\d?|2[0-4]?\d?|
25[0-5]?|[3-9]\d?)$) port Integer ITS800,ATLAS 端口号
最小值：0 最大值：65535 hardwareType String 参数说明：硬件类型。
取值范围：ITS800 或者 ATLAS 正则匹配：(ITS800|ATLAS) position_descr
iption String 参数说明：安装位置编码，由用户自定义。
取值范围：长度不低于1不超过128，只允许字 母、数字、下划线（_）的组合。
正则匹配：^[a-zA-Z0-9_]{1,128}$
location Location
object 参数说明：经纬度坐标。
camera_ids Array of
strings 参数说明：摄像头ID列表。
最小长度：0 最大长度：255
参数 参数类型 描述 local_rsus Array of
strings 参数说明：Edge关联的本地RSU列表。
最大长度：255 edge_general
_config EdgeGeneral
Config object Edge通用配置。
edge_advance
_config Object Edge高级配置，Json格式 最大长度：4096
status String "参数说明：状态。
取值范围：
● UNINSTALLED： 待部署
● INSTALLED：部署中
● OFFLINE：离线
● ONLINE：在线：
● UPGRADING：升级中
● DELETING：删除中
正则匹配：(UNINSTALLED|INSTALLED|OFFLINE|
ONLINE|UPGRADING|DELETING) node_id String 边缘管理服务返回的node_id，用于关联
EdgeManager的资源 最小长度：0
最大长度：255
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。
表1-151 Location
参数 参数类型 描述
lat Number 参数说明：定义纬度数值，北纬为正，南纬为 负，单位°，精度小数点后7位。
最小值：-90 最大值：90
参数 参数类型 描述
lon Number 参数说明：定义经度数值。东经为正，西经为 负。单位°，精度小数点后7位。
最小值：-180 最大值：180
表1-152 EdgeGeneralConfig
参数 参数类型 描述
avp_enabled Boolean 参数说明：AVP场景。
rsm_enabled Boolean 参数说明：RSM上报：默认不上报。
time_compen
sate Boolean 参数说明：时延补偿：是否启动Edge时延补偿功 能。
rsi_positionin
g_enabled Boolean 参数说明：RSI事件定位功能。
log_level String 参数说明：应用日志级别，可选项：on/off，默 认关闭。
缺省值：off 正则匹配：(on|off)
user_name String 参数说明：ITS800鉴权用的用户名和密码。
最小长度：0 最大长度：255 password String 参数说明：密码。
最小长度：0 最大长度：255
请求示例
POST https://{endpoint}/v1/{project_id}/v2x-edges Content-Type:application/json
X-Auth-Token:********
Instance-Id:********
{ "v2x_edge_id" : "74297d76-6f99-4fe2-a435-1e27a524e4c8", "name" : "name",
"description" : "test", "esn" : "ESN01234567",
"last_modified_time" : "2020-09-01T01:37:01Z"
}
响应示例
状态码： 201 Created
{ "name" : "name", "description" : "test", "esn" : "ESN01234567", "ip" : "127.0.0.1", "port" : "8880",
"hardwareType" : "ATLAS", "position_description" : "testtest"
}
状态码
状态码 描述
201 Created 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found
405 Method Not Allowed 409 Conflict
429 Too Many Requests 500 Internal Server Error
错误码
请参见错误码。