功能介绍
1.1.4.4 修改 RSU 功能介绍功能介绍
修改RSU
URI
PUT /v1/{project_id}/rsus/{rsu_id}
表1-18 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 参数说明：项目ID。获取方法请 参见 获取项目ID。
取值范围：仅支持数字，a到f的 小写字母组合，长度32。
正则匹配：^[0-9a-f]{32}$
rsu_id 是 String 参数说明：RSU的唯一标识符，
在平台创建RSU时由平台生成。
最小长度：0 最大长度：255
请求参数
表1-19 请求 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。简要的获取 方法样例请参见 Token认证。
最小长度：1 最大长度：20000
表1-20 请求 Body 参数
参数 是否必选 参数类型 描述
name 否 String 参数说明：RSU的名字。
取值范围：长度不低于1不超过 128，只允许中文、字母、数 字、下划线（_）、连接符（-）
的组合。
正则匹配：^[-a-zA-Z0-9_
\u4e00-\u9fa5]{1,128}$
参数 是否必选 参数类型 描述
description 否 String 参数说明：RSU的描述。
取值范围：只允许中文、字母、
ip 否 String 参数说明：RSU的IP。满足IP的
格式，例如127.0.0.1。
iption 否 String 参数说明：安装位置编码，由用
户自定义。
num 否 Integer 参数说明：RSU可关联的Edge
的数量，修改值需大于等于当前
表1-21 响应 Body 参数
参数 参数类型 描述
rsu_id String 参数说明：RSU的唯一标识符，在平台创建RSU 时由平台生成。
最小长度：0 最大长度：255
name String 参数说明：RSU的名字。
取值范围：长度不低于1不超过128，只允许中 文、字母、数字、下划线（_）、连接符（-）的 组合。
description String 参数说明：RSU的描述。
取值范围：只允许中文、字母、数字、下划线
esn String 参数说明：RSU的设备序列号。
取值范围：只允许字母、数字、下划线（_）的组
_time String 参数说明：最后修改的时间。
格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z created_time String 参数说明：创建的时间。
格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z last_online_ti
me String 参数说明：最后的在线时间。
格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z
参数 参数类型 描述
ip String 参数说明：RSU的IP。满足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?)$) position_descr
iption String 参数说明：安装位置编码，由用户自定义。
取值范围：长度不低于1不超过128，只允许字 母、数字、下划线（_）的组合。
正则匹配：^[a-zA-Z0-9_]{1,128}$
location RsuLocation
object 参数说明：RSU的位置信息。
status String 参数说明：RSU设备状态。
取值范围：
● ONLINE：在线
● OFFLINE：离线
● INITIAL：初始化
● UNKNOWN：未知
正则匹配：(ONLINE|OFFLINE|INITIAL|
UNKNOWN)
rsu_model_id String 参数说明：RSU型号ID，用于唯一标识一个RSU 型号，在平台创建RSU型号后由平台分配获得，
num Integer 参数说明：RSU可关联的Edge的数量。
最小值：0 最大值：64 software_versi
on String 参数说明：RSU的软件版本，由RSU上报其软件 版本。
最小长度：0 最大长度：255
表1-22 RsuLocation
参数 参数类型 描述
lat Number 参数说明：定义纬度数值，北纬为正，南纬为 负，单位°，精度小数点后7位。
最小值：-90 最大值：90
lon Number 参数说明：定义经度数值。东经为正，西经为 负，单位°，精度小数点后7位。
最小值：-180 最大值：180
请求示例
PUT https://{endpoint}/v1/{project_id}/rsus/{rsu_id}
Content-Type:application/json X-Auth-Token:********
Instance-Id:********
{ "name" : "RSU001", "description" : "TEST", "ip" : "127.0.0.1",
"position_description" : "K08", "related_edge_num" : 0 }
响应示例
状态码： 200 OK
{ "rsu_id" : "b58efc27-a6e5-4bca-9d12-c76ecfe3f102", "name" : "RSU001",
"description" : "TEST",
"esn" : "13518098671442480164720973683901", "last_modified_time" : "2020-09-01T01:37:01Z", "created_time" : "2020-09-01T01:37:01Z", "last_online_time" : "2020-09-01T01:37:01Z", "ip" : "127.0.0.1",
"position_description" : "K08", "location" : {
"lat" : 40.1234567, "lon" : 116.1234567 }, "status" : "ONLINE",
"rsu_model_id" : "27652459499824704332521974743806", "related_edge_num" : 0,
"software_version" : "V100X00XX00X325"
状态码
状态码 描述
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
错误码
请参见错误码。