功能介绍
1.1.5 RSU 型号管理
1.1.5.3 查询 RSU 型号 功能介绍功能介绍
}
状态码
状态码 描述
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
错误码
请参见错误码。
1.1.5.3 查询 RSU 型号 功能介绍
可调用此接口查询已创建的RSU型号。
URI
GET /v1/{project_id}/rsu-models/{rsu_model_id}
表1-32 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 参数说明：项目ID。获取方法请 参见 获取项目ID。
取值范围：仅支持数字，a到f的 小写字母组合，长度32。
正则匹配：^[0-9a-f]{32}$
rsu_model_id 是 String 参数说明：RSU型号ID，用于唯 一标识一个RSU型号，在平台创 建RSU型号后由平台分配获得。
取值范围：长度不小于1不超过 36，只允许字母、数字、连接 符（-）的组合。
正则匹配：^[a-zA-Z0-9-]
{1,36}$
请求参数
表1-33 请求 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
响应参数
状态码： 200
表1-34 响应 Body 参数
参数 参数类型 描述
rsu_model_id String 参数说明：RSU型号ID，用于唯一标识一个RSU 型号，在平台创建RSU型号后由平台分配获得。
取值范围：长度不小于1不超过36，只允许字 母、数字、连接符（-）的组合。
正则匹配：^[a-zA-Z0-9-]{1,36}$
name String 参数说明: RSU型号名称。
取值范围：长度不低于1不超过64，只允许中
_name String 参数说明: RSU的厂商名称。
取值范围：长度不低于1不超过32，只允许中
description String 参数说明: RSU型号的描述信息。
取值范围：长度不低于1不超过128，只允许中
_time String 参数说明: RSU型号更新的时间。
格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2020-12-07T01:32:17Z
created_time String 参数说明: 在平台创建RSU型号的时间。
格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2020-12-07T01:32:17Z
请求示例
GET https://{endpoint}/v1/{project_id}/rsu-models/{rsu_model_id}
Content-Type:application/json X-Auth-Token:********
Instance-Id:********
响应示例
状态码： 200 OK
{ "rsu_model_id" : "5ba24f5ebbe8f56f5a14f605", "name" : "RSU001",
"manufacturer_name" : "ABC", "description" : "excellent",
"created_time" : "2020-12-07T01:32:17Z", "last_modified_time" : "2020-12-07T01:32:17Z"
}
状态码
状态码 描述
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
错误码
请参见错误码。
URI
PUT /v1/{project_id}/rsu-models/{rsu_model_id}
表1-35 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 参数说明：项目ID。获取方法请 参见 获取项目ID。
取值范围：仅支持数字，a到f的 小写字母组合，长度32。
正则匹配：^[0-9a-f]{32}$
rsu_model_id 是 String 参数说明：RSU型号ID，用于唯 一标识一个RSU型号，在平台创 建RSU型号后由平台分配获得。
取值范围：长度不小于1不超过 36，只允许字母、数字、连接 符（-）的组合。
正则匹配：^[a-zA-Z0-9-]
{1,36}$
请求参数
表1-36 请求 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-37 请求 Body 参数
参数 是否必选 参数类型 描述
manufacturer
_name 否 String 参数说明: RSU的厂商名称。
取值范围：长度不低于1不超过 32，只允许中文、字母、数 字、下划线（_）、问号（?）、
反引号（'）、井号（#）、左小 括号（(）、右小括号（)）、点
（.）、逗号（,）、与（&）、
百分号（%）、At（@）、感叹 号（!）、连接符（-）的组合。
正则匹配：^[一-龥a-zA-Z0-9_?'#().,&%@!-]{1,32}$
description 否 String 参数说明: RSU型号的描述信 息。
取值范围：长度不低于1不超过 128，只允许中文、字母、数 字、下划线（_）、问号（?）、
反引号（'）、井号（#）、左小 括号（(）、右小括号（)）、点
（.）、逗号（,）、与（&）、
百分号（%）、At（@）、感叹 号（!）、连接符（-）的组合。
正则匹配：^[\s一-龥a-zA-Z0-9_?'#().,&%@!-]{1,128}$
响应参数
状态码： 200
表1-38 响应 Body 参数
参数 参数类型 描述
rsu_model_id String 参数说明：RSU型号ID，用于唯一标识一个RSU 型号，在平台创建RSU型号后由平台分配获得。
取值范围：长度不小于1不超过36，只允许字 母、数字、连接符（-）的组合。
正则匹配：^[a-zA-Z0-9-]{1,36}$
参数 参数类型 描述
name String 参数说明: RSU型号名称。
取值范围：长度不低于1不超过64，只允许中
_name String 参数说明: RSU的厂商名称。
取值范围：长度不低于1不超过32，只允许中
description String 参数说明: RSU型号的描述信息。
取值范围：长度不低于1不超过128，只允许中
_time String 参数说明: RSU型号更新的时间。
格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2020-12-07T01:32:17Z
created_time String 参数说明: 在平台创建RSU型号的时间。
格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如：2020-12-07T01:32:17Z
请求示例
PUT https://{endpoint}/v1/{project_id}/rsu-models/{rsu_model_id}
Content-Type:application/json X-Auth-Token:********
Instance-Id:********
{ "manufacturer_name" : "ABC", "description" : "excellent"
}
响应示例
状态码： 200 OK
{ "rsu_model_id" : "5ba24f5ebbe8f56f5a14f605", "name" : "RSU001",
"manufacturer_name" : "ABC", "description" : "excellent",
"last_modified_time" : "2020-12-07T01:32:17Z"
}
状态码
状态码 描述
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
错误码
请参见错误码。