创建车辆

project_id

是

String

参数说明：项目ID。获取方法请参见“API参考 > 附录 > 获取项目ID”。

取值范围：仅支持数字，a到f的小写字母组合，长度32。

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

vehicle_id

是

String

参数说明：车辆唯一标识符。

取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。

plate_no

否

String

参数说明：车牌号。

取值范围：长度最小1最大64，支持中文、阿拉伯文、字母、数字、下划线（_）、横杠（-）的组合。

vin

否

String

参数说明：VIN码，车辆的17位VIN码。

取值范围：长度不超过17，只允许字母、数字字符的组合。

最大长度：17

obu_id

否

String

参数说明：车载OBU的唯一标识。

取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。

imei

否

String

参数说明：IMEI，OBU上电子序列号。

取值范围：长度最小1最大255，支持纯数字的组合。

brand

否

String

参数说明：车俩品牌。

取值范围：长度最小1最大64，支持中文、字母、数字、下划线（_）、横杠（-）的组合。

model

否

String

参数说明：车牌型号。

取值范围：长度最小1最大64，支持字母、数字、下划线（_）、横杠（-）的组合。

style

否

String

参数说明：车辆年款。

取值范围：长度最小1最大64，支持纯数字的组合。

fuel_type

否

String

参数说明：定义车辆的燃料动力类。

取值范围：

• unknownFuel：未知

• gasoline：汽油

• ethanol：乙醇

• diesel：柴油

• electric：电动

• hybrid：混合燃料类型

• hydrogen：氢气

• natGasLiquid：液化天然气

• natGasComp：压缩天然气

• propane：丙烷

color

否

String

参数说明：车辆颜色。

取值范围：

• black：黑色

• white：白色

• gray：灰色

• red：红色

• blue：蓝色

• yellow：黄色

• orange：橙色

• brown：棕色

• green：绿色

• purple：紫色

• cyan：青色

• pink：粉红色

• transparent：透明色

• other：其他

plate_color

否

String

参数说明：车辆颜色。

取值范围：

• black：黑色

• white：白色

• blue：蓝色

• yellow：黄色

• green：绿色

access_type

否

String

参数说明：车辆接入网络的方式。

取值范围：

• 5g

• 4g

• 3g

• 2g

• pc5Only

• pc5And5g

• pc5And4g

• pc5And3g

• pc5And2g

secret

是

String

参数说明：第三方车辆密钥，输入车辆型号ID后方可填写该字段以设置方车辆密码。

最小长度：8

最大长度：32

description

否

String

参数说明：描述。

取值范围：长度不超过2048，只允许中文、字母、数字、下划线（_）、中文分号（；）、中文冒号（：）、中文问号（？）、中文感叹号（！）中文逗号（，）、中文句号（。）、英文引号（;）、英文冒号（:）、英文逗号（,）、英文句号（.）、英文问号（?）、英文感叹号（!）、顿号（、）、连接符（-）的组合。

最大长度：2048

vehicle_id

String

参数说明：车辆唯一标识符。

取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。

plate_no

String

参数说明：车牌号。

取值范围：长度最小1最大64，支持中文、阿拉伯文、字母、数字、下划线（_）、横杠（-）的组合。

vin

String

参数说明：VIN码，车辆的17位VIN码。

取值范围：长度不超过17，只允许字母、数字字符的组合。

最大长度：17

obu_id

String

"参数说明：车载OBU的唯一标识。

取值范围：长度不超过128，只允许字母、数字、以及_-等字符的组合。

imei

String

参数说明：IMEI，OBU上电子序列号。

取值范围：长度最小1最大255，支持纯数字的组合。

brand

String

参数说明：车俩品牌。

取值范围：长度最小1最大64，支持中文、字母、数字、下划线（_）、横杠（-）的组合。

model

String

参数说明：车牌型号。

取值范围：长度最小1最大64，支持字母、数字、下划线（_）、横杠（-）的组合。

style

String

参数说明：车辆年款。

取值范围：长度最小1最大64，支持纯数字的组合。

fuel_type

String

参数说明：定义车辆的燃料动力类。

取值范围：

• unknownFuel：未知

• gasoline：汽油

• ethanol：乙醇

• diesel：柴油

• electric：电动

• hybrid：混合燃料类型

• hydrogen：氢气

• natGasLiquid：液化天然气

• natGasComp：压缩天然气

• propane：丙烷

color

String

参数说明：车辆颜色。

取值范围：

• black：黑色

• white：白色

• gray：灰色

• red：红色

• blue：蓝色

• yellow：黄色

• orange：橙色

• brown：棕色

• green：绿色

• purple：紫色

• cyan：青色

• pink：粉红色

• transparent：透明色

• other：其他

plate_color

String

参数说明：车辆颜色。

取值范围：

• black：黑色

• white：白色

• blue：蓝色

• yellow：黄色

• green：绿色

access_type

String

参数说明：车辆接入网络的方式。

取值范围：

• 5g

• 4g

• 3g

• 2g

• pc5Only

• pc5And5g

• pc5And4g

• pc5And3g

• pc5And2g

description

String

参数说明：描述。

取值范围：长度不超过2048，只允许中文、字母、数字、以及_?'#().,&%@!-空格等字符的组合。

最大长度：2048

last_modified_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_time

String

参数说明：最后的在线时间。格式：yyyy-MM-dd'T'HH:mm:ss'Z' 例如 2020-09-01T01:37:01Z

status

String

参数说明：设备状态。

取值范围：

• ONLINE：在线

• OFFLINE：离线

• INITIAL：初始化

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