华为云用户手册

URI GET /v3/{project_id}/{resource_type}/{resource_id}/tags 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目编号，用于资源隔离。获取方式请参考获取项目ID。 resource_type 是 String 资源类型。 dli_queue：队列 dli_elastic_resource_pool：弹性资源池 dli_enhanced_datasource：增强型跨源连接 dli_database：数据库 dli_package_resource：资源包（不支持指定有Module ID的内置资源包） dli_flink_job：Flink作业 resource_id 是 String 资源ID。 最小长度：1 最大长度：1000 获取方式： 队列ID：通过调用查询所有队列获队列ID。响应中的queue_id为队列ID。 弹性资源池ID：通过调用查询所有弹性资源池获弹性资源池ID。响应中的resource_id为弹性资源池ID。 增强型跨源连接ID：在 DLI 管理控制台的“增强型跨源连接”列表页获取“连接ID”即为增强型跨源连接ID。 数据库ID：添加标签时候传入的数据库ID即数据库名。您可以在DLI控制台的“库表管理”页面查看数据库名称。 Flink作业ID：在DLI管理控制台的“Flink作业”列表页面单击Flink作业名称，在Flink作业的详情页面即可获取Flink作业ID。 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 Integer 每页显示条数，默认为1000。 offset 否 Integer 查询结果偏移量，默认为0。

响应参数 状态码： 200 表3 响应Body参数 参数名称 参数类型 说明 is_success Boolean 执行请求是否成功。“true”表示请求执行成功。 message String 系统提示信息，执行成功时，信息可能为空。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述信息。 状态码： 500 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述信息。

注册华为账号 并开通华为云 如果您已完成华为账号注册，可以跳过该步骤。 打开华为云官方网站。 单击华为云官网右上角“注册”进入注册页面。 在注册页面，输入手机号，并获取并输入手机收到的验证码。 请使用中国大陆的手机号码。 一个手机号可以注册3个华为账号，如账号数量已达到3个，将不支持使用该手机号注册新的华为账号。 设置账号密码，并单击“注册”。 至少包含8个字符。 至少包含字母和数字，不能包含空格。 勾选服务条款，单击“开通”。

D CS 实例如何缩容？ DCS实例支持扩容和缩容明细如下表1。 表1 实例规格变更明细 缓存类型 单机实例 主备实例 Cluster集群实例 Proxy集群实例 读写分离实例 Redis 3.0 支持扩容和缩容 支持扩容和缩容 - 仅支持扩容 - Redis 4.0 支持扩容和缩容 支持扩容、缩容和副本数变更 支持扩容、缩容和副本数变更 支持扩容和缩容 支持扩容、缩容和副本数变更 Redis 5.0 支持扩容和缩容 支持扩容、缩容和副本数变更 支持扩容、缩容和副本数变更 支持扩容和缩容 支持扩容、缩容和副本数变更 Redis 6.0 基础版 支持扩容和缩容 支持扩容和缩容 支持扩容、缩容和副本数变更 支持扩容和缩容 支持扩容、缩容和副本数变更 Redis 6.0 企业版 - 支持扩容和缩容 - - - Memcached 支持扩容和缩容 支持扩容和缩容 - - - 实例扩容、缩容操作请参考规格变更。 如果Redis 3.0 Proxy集群需要缩容，可以先进行数据备份，然后另外创建对应规格的Proxy集群实例，使用备份文件导入方式，将备份数据文件导入到新的Proxy集群实例。待数据迁移完成后，再释放原来规格的Proxy集群实例。在线迁移操作，可以参考备份文件导入方式。 父主题： 扩容缩容与实例升级

Redis实例是否支持版本升级，如Redis 4.0升级到Redis 5.0？ 暂不支持直接升级。Redis不同版本的底层架构不一样，在创建Redis实例时，确定Redis版本后，不能修改，如Redis 4.0的实例不能升级到Redis 5.0。 如您的业务需要使用Redis高版本的功能特性，可重新创建高版本Redis实例，然后将原有Redis实例的数据迁移到高版本实例上。具体数据迁移操作，可参考数据迁移指南。 父主题： 扩容缩容与实例升级

API概览 类型 说明 RSU管理 包括RSU的创建、删除、修改、查询接口。 雷达管理 包括RSU型号的创建、删除、修改、查询接口。 Edge应用管理 包括Edge应用的创建、删除、修改、查询接口。 Edge应用版本管理 包括Edge应用版本的创建、删除、修改、更新、查询接口。 边缘应用管理 包括边缘应用的部署、删除、升级、查询接口。 信号机管理 包括Edge的创建、删除、修改、查询等接口。 长期交通事件管理 包括业务通道的创建、删除、修改、查询接口。 车辆管理 包括IPC的查询接口。 IPC管理 包括雷达信息的查询接口。 RSU型号管理 包括信号机的获取、创建、删除、修改接口。 业务通道管理 包括车辆的获取、创建、删除、修改接口。 Edge管理 包括交通事件的创建、删除、修改、查询接口。 历史交通消息管理 创建即时交通事件。 即时交通事件管理 包括数据转发配置的创建、删除、更新、查询接口。 数据转发 包括bsm、rsi、rsm、spat、statistics、tracks消息转发。 数据转发配置管理 下发交通消息给设备侧，当前仅支持下发SPAT消息给RSU设备。 交通消息下发 查询历史交通事件。 父主题： 应用侧API参考

Token认证 Token是服务端生成的一串字符串，作为客户端进行请求的一个令牌。第一次登录后，服务器生成一个Token并将此Token返回给客户端，以后客户端只需带上这个Token前来请求数据即可，无需再次带上用户名和密码。Token有效期是24小时，从客户端获取开始算起（24小时是相对时间），需要使用同一个Token鉴权时，建议缓存起来使用，避免频繁调用。在Token过期前，务必刷新Token或重新 获取Token ，否则Token过期后会在服务端鉴权失败。 如果您获取Token多次，以最新的为准，前面的Token会被覆盖并失效。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxxxxxxx" } } } } 加粗的斜体字段需要根据实际值填写，其中username为 IAM 用户名，domainname为IAM用户所属帐号名，********为IAM用户的登录密码，xxxxxxxxxxxxxxxxxx为IAM用户所属账号的项目名称，如“cn-north-1”，您可以参考我的凭证页面获取。 接口返回的响应消息头中“X-Subject-Token”就是需要获取的用户Token。 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值为获取到的Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 POST https://ocv2x-api.cn-north-4.myhuaweicloud.com/v1/{project_id}/traffic-events Content-Type: application/json X-Auth-Token: ABCDEFJ.... Instance-Id: xxxxxx 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333。

AK/SK认证 AK/SK签名认证方式仅支持消息体大小12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK（Access Key ID）：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK（Secret Access Key）：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的帐号名称，********为用户登录密码，xxxxxxxxxxxxxxxxxx为project的名称，如“cn-north-1”，您可以从地区和终端节点获取。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token额作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxxxxxxxxxxx" } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。 在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表格内容。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 否 使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 是 application/json Instance-Id 路网数字化服务 的实例ID，请参考获取Instance-Id获取实例ID。 否 部分接口调用要求必选。 c7ff8b76-9e6c-46c1-863e-a2225bb637ef project-id project id，项目编号。请参考获取项目ID章节获取项目编号。 否 如果是专属云场景采用AK/SK认证方式的接口请求或者多project场景采用AK/SK认证的接口请求，则该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。 否 使用Token认证时该字段必选。 注：以下仅为Token示例片段 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证是使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器 域名 或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点中获取。 例如IAM服务在“华北-北京一”区域的Endpoint为“iam.cn-north-1.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如您需要获取IAM在“华北-北京一”区域的Token，则需使用“华北-北京一”区域的Endpoint（iam.cn-north-1.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 DRIS.00000002 Invalid input. %s 请求参数不合法 请排查请求参数是否符合文档定义。 400 DRIS.00000012 Resource create failed. 开通资源失败 请联系华为工程师分析解决。 400 DRIS.00000013 Resource already exist. This domain is already create resource. 资源已经存在 资源已经存在，请勿重复开通资源。 400 DRIS.00010001 The RSU ESN already exists. RSU esn已经存在 请更换esn后重试。 400 DRIS.00010005 The RSU model name already exists. RSU型号名称已存在 请更换名称后重试。 400 DRIS.00020002 Invalid input, event type invalid. 事件分类和事件类型不匹配 请参考国标交通事件编码填写。 400 DRIS.00020003 Invalid input, no tenant id found! 帐号ID不合法 请联系华为工程师分析解决。 400 DRIS.00030001 Invalid input. No matching RSU found for this event. 事件位置范围内未匹配到RSU 请检查事件位置是否正确。 400 DRIS.00100001 The number of RSU connection to Edges have reached the upper limit. RSU可关联的Edge数量达上限 请参考修改一个RSU资源调整RSU可关联的Edge数量。 400 DRIS.00100003 The EdgeApps are repeated. Edge App已经存在 请更换edge_app_id后重试。 400 DRIS.00120002 IPC ESN duplicate IPC设备已经存在 请更换esn后重试。 400 DRIS.00130003 Create install command failed. 生成边缘节点安装命令失败 请联系华为工程师分析解决。 400 DRIS.00200000 Instance not found. dris实例不存在 请确认携带的instance_id是否正确。 400 DRIS.00210001 Unknown system mode. 未知的系统模式 请确认携带的systemMode是否正确。 400 DRIS.00210003 Incremental updates are not supported. License不支持增量更新 请尝试使用全量更新操作。 400 DRIS.00210008 ESN not match can not apply. 激活license时esn匹配失败 请联系华为工程师分析解决。 400 DRIS.00280001 The Vehicle VehicleId already exists. 车辆ID已经存在 请更换vehicle_id后重试。 400 DRIS.00290001 The TrafficController TrafficControllerId already exists. 信号机设备已存在 请更换traffic_controller_id后重试。 400 DRIS.00340002 The file not found! 文件不存在 请确认对应file_id的文件是否已经导入到平台。 400 DRIS.00340003 The file has imported! 文件中的设备已经创建 请更换文件后重试。 400 DRIS.00350004 The linkAssetRelation file not found! 该file_id对应的路段设备关系文件不存在 请确认对应file_id的文件是否已经导入到平台后重试。 401 DRIS.00000004 Token is invalid. token不合法 请排查请求中的token是否正确或是否过期。 401 DRIS.00000007 Resource unauthorized. The instance does not belong to this authorized user. 资源未授权 请确认是否已开通资源。 401 DRIS.00000010 Resource unauthorized. URL's project id doesn't match token. 资源访问受限 请检查携带的token是否有权限访问url中指定project_id的项目。 403 DRIS.00000005 Resource limit reached. 请求的资源配额已达上限 请联系华为工程师分析解决。 403 DRIS.00000006 Resource is frozen. 资源已被冻结 请联系华为工程师分析解决。 403 DRIS.00000009 Operation not allowed. The user does not have the permission of this API. 无权访问此API 请联系华为工程师确认用户的权限策略。 403 DRIS.00010004 Rsu resource reach limit. RSU可关联的Edge数量达上限 请参考修改一个RSU资源调整RSU可关联的Edge数量。 403 DRIS.00020004 Traffic event resource reach limit. 交通事件数量达上限 请删除一些交通事件后重试。 403 DRIS.00031005 Simulation task is running! 仿真任务正在执行中 请在任务执行完成后再操作。 403 DRIS.00031006 Simulation task lack scenes! 仿真任务缺少任务应用场景 请根据任务类型补全对应场景。 403 DRIS.00130001 Request forbidden. The system app $edgetepa must be deployed first. 部署边缘应用失败 请先部署边缘系统应用。 403 DRIS.00130005 The EdgeApp cannot be deleted because it has associated DataChannels. 删除边缘应用失败 Edge设备的业务通道存在时无法直接删除边缘应用，请先删除业务通道后重试。 403 DRIS.00150001 Max configurations (10) exceeded. 租户数据转发配置资源（Kafka）数量达上限 请删除未使用的数据转发配置后重试。 403 DRIS.00150002 The broker in your request already exists. Check your Kafka configurations. 数据转发配置中的broker地址已经存在 请更换broker地址及用户名密码后重试。 403 DRIS.00190001 The algorithm model for this function of this road network already exists. 算法模型已经存在 请确认对应road_network_id和model_function的算法模型是否已经添加到平台。 403 DRIS.00190002 The algorithm model of this version is in use. 指定版本的算法模型已经在使用中 请确认此版本的算法模型处于非使用状态后重试 403 DRIS.00200002 Forbidden to operate instance. 禁止操作dris实例 请联系华为工程师分析解决。 403 DRIS.00280003 Vehicle resource reach limit. 车辆数量达上限 请联系华为工程师分析解决。 403 DRIS.00290003 TrafficController resource reach limit. 信号机设备数量达上限 请联系华为工程师分析解决。 403 DRIS.00350001 The number of devices of the same data type on one link exceeds the limit! 该路段下同种数据类型的绑定设备数量超过限制 请先解绑该路段下对应数据类型的已绑定设备后重试。 403 DRIS.00350002 The total number of linkAssetRelation exceeds the limit! 绑定路段设备关系总数超过限制 请先解绑部分未使用的路段设备关系后重试。 403 DRIS.00350003 The linkAssetRelation not bound! 该路段设备关系未绑定 请确认当前输入的link_id,esn,data_type对应的路段设备关系已绑定。 403 DRIS.00350005 The number of subTasks in the file exceeds limit 该文件下对应的子任务数量超过限制 请减少文件中的待操作的数据条数以符合限制后重试。 403 DRIS.00350006 The linkAssetRelation task is running! 已有路段设备任务正在执行 请在当前任务完成后再重试。 404 DRIS.00000011 Resource not found. 资源不存在 请确认是否已开通资源。 404 DRIS.00010002 The RSU not found. RSU不存在 请确认对应的rsu_id或esn是否已经在平台创建RSU。 404 DRIS.00010003 Rsu model not found. RSU型号不存在 请确认对应的rsu_model_id是否已经在平台创建RSU型号。 404 DRIS.00020001 This traffic event is not found. 交通事件不存在 请确认对应的event_id是否已经在平台创建交通事件。 404 DRIS.00040001 Area config not found. 区域配置不存在 请确认对应的area_code是否已经在平台添加区域配置。 404 DRIS.00080001 Rule config not found 交通事件规则配置不存在 请确认对应的event_type或position_id是否已经在平台新增规则。 404 DRIS.00090001 Edge not found. Edge设备不存在 请确认对应的v2x_edge_id是否已经在平台创建Edge设备。 404 DRIS.00100002 The EdgeApp not found. Edge App不存在 请确认对应的edge_app_id是否已经在平台创建Edge App。 404 DRIS.00100004 The EdgeAppVersion not found. Edge App版本不存在 请确认对应的version是否已经在平台创建Edge App版本。 404 DRIS.00120001 This camera does not exist. IPC设备不存在 请确认对应camera_id的IPC设备是否已经添加到平台。 404 DRIS.00130002 The V2XEdgeApp not found 边缘应用不存在 请确认对应v2x_edge_id和edge_app_id的边缘应用是否已经部署。 404 DRIS.00130004 DataChannel not found 业务通道不存在 请确认指定Edge设备（v2x_edge_id）是否已经在平台创建业务通道 404 DRIS.00150003 Kafka config not found 数据转发配置资源（Kafka）不存在 请确认对应的forwarding_config_id是否已经在平台创建数据转发配置。 404 DRIS.00170001 Not Found. 地图区间不存在 请确认地图区间是否已经在平台添加。 404 DRIS.00180001 Not Found. 资源不存在 请确认是否已开通资源。 404 DRIS.00190003 The algorithm model not found. 算法模型不存在 请确认对应model_id的算法模型是否已经添加到平台。 404 DRIS.00210000 The license file does not exist and cannot be updated. License文件不存在 请确认携带的lsn是否正确。 404 DRIS.00210004 ESN not found. license esn不存在 请联系华为工程师分析解决。 404 DRIS.00220001 The file not found. 文件不存在 请联系华为工程师分析解决。 404 DRIS.00230001 The interaction not found. 对接系统不存在 请确认对应interaction_id的对应系统是否已经在平台配置。 404 DRIS.00240001 The ITS asset not found. 交通设施不存在 请确认对应its_asset_id的交通设施是否已经在平台添加。 404 DRIS.00250001 Link not found. 路段不存在 请确认对应link_id的路段是否已经在平台添加。 404 DRIS.00260001 The Road network not found. 路网不存在 请确认对应road_network_id的路网是否已经在平台生成。 404 DRIS.00270001 The control strategy not found. 管控策略不存在 请确认对应strategy_id的管控策略是否已经在平台下发。 404 DRIS.00280002 The Vehicle not found. 车辆不存在 请确认对应vehicle_id的车辆资源是否已经在平台创建。 404 DRIS.00290002 The TrafficController not found. 信号机设备不存在 请确认对应traffic_controller_id的信号机设备是否已经在平台创建。 404 DRIS.00300001 The datasource not found. 数据源不存在 请检查data_source_id是否正确。 404 DRIS.00310001 The simulation task not found! 仿真任务不存在 请确认对应task_id的仿真任务是否已经在平台创建。 404 DRIS.00320001 The common scene not found! 仿真任务普通场景不存在 请确认对应task_id和common_id的普通场景仿真任务是否已经在平台创建。 404 DRIS.00320002 The accident scene not found! 仿真任务事故场景不存在 请确认对应task_id和accident_id的事故场景仿真任务是否已经在平台创建。 404 DRIS.00320003 The construction scene not found! 仿真任务施工场景不存在 请确认对应task_id和construction_id的施工场景仿真任务是否已经在平台创建。 404 DRIS.00320004 The common speed-limit scene not found! 仿真任务限速场景不存在 请确认对应task_id和speed_limit_id的限速场景仿真任务是否已经在平台创建。 404 DRIS.00320005 The common flow-control scene not found! 仿真任务匝道流控场景不存在 请确认对应task_id和flow_control_id的匝道流控场景仿真任务是否已经在平台创建。 404 DRIS.00320006 The emergency-lan-open scene not found! 仿真任务开放应急车道场景不存在 请确认对应task_id和emergency_lan_open_id的开放应急车道场景仿真任务是否已经在平台创建。 404 DRIS.00330001 The statistics result not found! 仿真任务的统计结果不存在 请检查任务是否已经执行成功。 404 DRIS.00330002 The detector result not found! 仿真任务的检测器结果不存在 请检查任务是否已经执行成功且检测器已经存在。 404 DRIS.00340001 The task not found! 任务不存在 请确认对应task_id的任务是否已经在平台创建。 404 DRIS.00350007 The linkAssetRelation task not found! 该task_id对应的路段设备关系任务不存在 请确认对应task_id的路段设备关系任务是否已经在平台创建。 405 DRIS.00000003 Method not allowed. Http request method not supported, just supports: %s Http Method不合法 请排查Http Method是否与文档一致。 429 DRIS.00000008 Request reached the maximum rate limit %s. 请求被流控 请在流控范围内请求接口。 500 DRIS.00000001 Internal server error. %s 服务器内部错误 请联系华为工程师分析解决。 500 DRIS.00200001 Instance create failed. %s 创建dris实例失败 请联系华为工程师分析解决。 500 DRIS.00200003 Create vpc endpoint failed. 创建vpcep失败 请联系华为工程师分析解决。 500 DRIS.00200004 Create iotda out channel failed. 创建IoTDA的网络通道失败 请联系华为工程师分析解决。 500 DRIS.00210002 Update device limit failed. 更新设备数上限配置时发生错误 请联系华为工程师分析解决。 500 DRIS.00210005 Get key file content failed. 获取license key文件失败 请联系华为工程师分析解决。 500 DRIS.00210006 Get revoke code failed. 更新license为失败状态时获取失效码失败 请联系华为工程师分析解决。 500 DRIS.00210007 Parse license failed. license解析失败 请联系华为工程师分析解决。

概述 欢迎使用路网数字化服务（Digital Road Infrastructure Service，DRIS），本服务通过车路协同、物联网等智能技术，打造人、车、路、云的全面协同，构建协作式的智慧交通，使能协同式的自动驾驶，给出行者提供更安全、更高效、更便捷的出行，给管理者提供全路段感知、全天候通行、全过程管控的智慧运营。 您可以使用本文档提供的API对道路设备和感知事件等资源进行相关操作，如RSU资源管理、交通事件资源管理等，支持的全部操作请参见API概览。业务数据开放接口的数据集定义满足标准编号为YD/T 3709-2020的《基于LTE的车联网无线通信技术 消息层技术要求》以及标准编号为 TCS AE 53-2017的《合作式智能运输系统 车用通信系统应用层及应用数据交互标准》的标准要求。 在调用DRIS API之前，请确保已经充分了解路网数字化服务相关概念，详细信息请参见产品介绍。 父主题： 使用前必读

组合应用 ROMA Connect可通过组合应用进行应用的复合集成，通过开放的API和事件通道进行应用的多次组装，形成新的组合应用，实现业务快速复制创新，形成千人千面的集成体验。内置海量连接器，提供各种数据库、API、消息、SaaS应用等的连接器封装。同时提供自定义连接器框架，可快速按需扩展定制；提供丰富的预置组合应用集成模板和生态连接器，联合各行各业的伙伴积累行业资产，开箱即用。 表5 组合应用功能 功能 简介 组合应用 在画布页面对各种触发器、连接器、处理器进行编排和配置，组合成新的组合应用。 智能助手 智能助手通过NLP (Natural Language Processing) 机器学习，理解用户输入的集成业务需求，匹配系统支持的触发器、连接器和数据处理器，生成组合应用。可以对生成的组合应用进一步配置和编排，最后构建，部署上线。 组合应用模板 提供丰富的预置组合应用集成模板，帮助用户快速便捷的创建组合应用。 引用变量 用户在编辑设计组合应用时，可以通过变量的方式快速引用流任务中的输入输出信息和配置信息，帮助用户便捷高效的设计组合应用。 在线调试 创建组合应用和工作流并配置完成后，可对工作流进行在线调试，实时查看各个节点的运行信息，便于后续对工作流进行调整以满足业务需求。 监控统计 提供组合应用运行记录、系统日志、运行监控等监控信息统计。

LINK 设备集成（LINK）是ROMA Connect的设备集成组件。设备集成使用MQTT标准协议连接设备，帮助企业快速、简单地实现设备云端管理。 例如工业场景中，设备的信息和生产过程中的参数比较分散。生产线出现故障时，如果靠人工采集每一台设备的信息与参数，定位问题的过程缓慢。设备集成能够连接设备和IT系统、大数据平台，将设备的运行状态等信息上传到IT系统或大数据平台，实现所有设备的信息可视化，一旦生产线出现故障，企业能够快速定位问题。通过配置LINK的规则引擎，把设备参数的极限值输入到设备引擎里面，如果设备的实时参数一直在向极限值接近，就发出告警信息，提醒用户停止设备，对设备进行维护和保养。 表4 LINK功能 功能 简介 发布和订阅消息 LINK支持标准的MQTT协议，企业可以使用开源的标准MQTT设备端SDK将设备轻松接入云端，进行消息的发布和订阅。 实现设备与后端各应用的消息互通 用户可以在控制台配置规则引擎实现设备与其他设备、后端、其他云服务的消息互通。 LINK支持规则引擎转发数据到消息集成MQS。第三方服务通过MQS服务获取数据，实现设备与第三方服务的异步消息通信。 支持海量设备低延时接入 LINK支持Broker水平扩展，支持百万设备长连接。 支持设备与应用之间的双向同步 LINK支持物模型定义，模型与设备影子绑定。用户可以基于设备影子实现设备与应用之间配置数据、状态数据的双向同步。 一方面，用户可以通过API将配置参数设置到设备影子里，设备在线或上线时，都可以从设备影子获取配置参数。另一方面，设备可以将最新状态上报到设备影子。用户查询设备状态时，只需查询设备影子，而不必与设备进行直接网络通信。 保证信息传输的安全 LINK提供设备、应用授权认证及Topic的双向绑定授权，保障设备安全与唯一性，提供TLS标准的数据传输通道保障消息传输通道的安全。

FDI 快速数据集成FDI（Fast Data Integration，简称FDI）是ROMA Connect的数据集成组件。FDI支持多种数据源（文本、消息、API、关系型数据和非关系型数据等）之间的灵活、快速、无侵入式的数据集成，可以实现跨机房、跨数据中心、跨云的数据集成方案，并能自助实施、运维、监控集成数据。 例如集团企业场景中，企业与合作伙伴使用的数据源不一样，难以形成企业之间有效的信息传输。FDI提供了多种数据源之间转换的方式，支持MySQL、Kafka、API等主流格式之间的转换。 表1 FDI功能 功能 简介 数据集成任务的生命周期管理 FDI支持修改数据集成任务的信息、查看数据集成任务的运行报告、查看数据集成任务的运行日志、查看数据集成任务状态，完成数据集成任务的生命周期管理功能。 灵活的数据读写 支持 MySQL、文本文件、消息、API等多种数据的分片读取和写入。 如果服务意外中断 ，修复服务之后FDI支持自动修复任务。 支持任务调度、任务监控、任务中断续读。 可靠的数据传输通道 FDI可以持续监测数据通道中的数据，支持100个以上的线程并发执行。FDI实时监测消息队列把数据实时写入目标队列。 任务调度 FDI提供全面、灵活、高可用的任务调度服务，支持通过API或以消息方式进行数据集成。按照时间、数据数量等任务触发规则来调度任务。根据任务配置，为插件分配任务，并监控和记录任务的执行状态。 企业根据不同的业务需求，可以选择不同的数据集成方式： 实时增量集成适用于需要实时监控数据变化的业务场景，例如收集生产线上设备的实时参数。 实时全量集成适用于需要实时监控所有历史数据的业务场景，例如统计供应商合作伙伴的出货量。 定时增量集成适用于监控一段时间内数据变化的业务场景，例如企业采用新的生产策略后，验证生产效率是否达到预期效果。 定时全量集成适用于监控一段时间内所有历史数据的业务场景，例如统计上下班高峰期内出入园区的车辆数目。 监控告警 对创建的数据集成任务的运行情况进行监控，并对异常的任务进行处理，保证业务正常运行。

APIC 服务集成APIC（API Connect，简称APIC）是ROMA Connect的API集成组件。APIC将数据和后端服务以API形式开放，简化分享数据或提供服务的过程，降低企业之间对接的成本。APIC提供不同语言的SDK和示例代码，简化企业以API形式开放后端服务的过程。 例如集团与各地区子公司的IT系统集成，直接访问对方各类数据库方式过于复杂，且容易发生信息泄露风险，如果以API方式互相开放访问，同时加强API调用安全防护，就能实现跨网络跨地域协同办公。 表2 APIC功能 功能 简介 API生命周期管理 APIC提供包括API的创建、发布、下线和删除的完整生命周期管理功能。 便捷调试工具 APIC提供页面调试工具，简化API开发，降低API的维护成本。 版本管理 一个API可以发布不同的版本到不同的环境，以满足业务版本升级等需求。 流量控制 用于管控API的请求频率、用户的请求频率和应用的请求频率。 流量控制的时间单位可以是秒、分钟、小时或天。允许设置特殊的应用，不受到流量控制策略的影响。 监控统计 提供实时、可视化的API监控，包括：API请求次数、API调用错误信息。 环境变量 当API发布到不同环境时，一般通过在API调用的请求头增加指定的头部参数及特殊取值区分不同的环境。发布过程中变量标识会根据环境的变量值进行替换，保证API本身定义不变。 自定义后端 包括自定义Data API与自定义Function API。 自定义Data API指企业将数据库作为API后端服务接入APIC，将数据服务能力转换为REST接口的能力。 自定义Function API，类似简化版的函数服务，在APIC后端编写自定义脚本或函数，作为API后端服务，供前端统一调用。

MQS 消息集成（Message Queue Service，简称MQS）是ROMA Connect的消息集成组件。MQS支持Kafka协议，使用统一的消息接入机制，为企业提供跨网络访问的安全、标准化消息通道。 例如企业与合作伙伴使用的消息系统不一样，消息系统对接成本较高，而且难以保证对接之后消息传输的可靠性和安全性。企业之间可以约定使用Kafka通信协议，那么MQS可以作为消息中转站，提供安全、可靠的消息传输通道。企业创建多个topic，设置每个合作伙伴订阅topic的权限，然后将消息发布到多个topic中。合作伙伴通过订阅topic，获取topic内的消息。 表3 MQS功能 功能 简介 原生Kafka基础功能 MQS除了支持客户端连接后管理Topic和发布订阅消息，还支持在ROMA Connect控制台可视化操作，包括Topic创建和管理、用户管理与权限设置、消息查询等功能。 监控报警 MQS从实例、节点、Topic、消费组等多个维度，设立了不同监控指标，数据上报 云监控服务 ，企业可以在 云监控 服务的管理控制台查看相关监控数据。MQS支持企业配置告警规则，轻松实现监控数据概览与异常告警。 消息查看 MQS提供了可视化的消息查询功能，可在界面查看Topic中存储的消息数据，可以更直观方便的查看消息正文。

配置参数 表1 获取记录 参数 说明 表名 选择或者填写要查询的数据库中的表名。 字段名 选择要查询数据表的字段名。 WHERE条件 配置要查询数据的条件值（注意值要用英文单引号包住）。 Order by字段 填写返回结果的排序字段。 Limit条数 填写返回结果的每页数据条数。 Offset偏移量 填写分页查询的偏移量。 表2 添加记录 参数 说明 表名 选择或者填写数据库中要插入数据的表名。 插入数据 填写插入操作中目标字段的值（注意值要用英文单引号包住）。 表3 更新记录 参数 说明 表名 选择或者填写数据库中要更新数据的表名。 更新数据 填写更新操作中目标字段的值（注意值要用英文单引号包住）。 WHERE条件 配置要更新数据的条件值（注意值要用英文单引号包住）。 表4 增量获取记录 参数 说明 表名 选择或者填写要增量获取记录的数据库中的表名。 字段名 选择要查询数据表的字段名。 WHERE条件 配置要查询数据的条件值（注意值要用英文单引号包住）。 Order by字段 填写返回结果的排序字段。 增量获取时区 增量数据获取开始时区。 增量获取时间戳字段 增量数据获取的时间戳字段。 增量获取时间戳初始值 增量数据获取的时间戳初始值。 重置增量获取时间初始值 选择是否开启重置增量获取时间初始值。 增量获取时间补偿(毫秒） 增量获取补偿增量迁移初始时间戳。 表5 删除记录 参数 说明 表名 选择或者填写数据库中要删除数据的表名。 WHERE条件 配置要删除数据的条件值（注意值要用英文单引号包住）。 表6 同步数据 参数 说明 表名 选择或者填写数据库中要同步数据的表名。 清空表 每次同步数据，是否先清空表。 表7 自定义SQL 参数 说明 执行语句 填写操作数据库的原生SQL语句。 执行语句内容会明文展示所输入信息，请防止信息泄露。 请谨慎使用drop、truncate等非查询类语句。

创建Oracle连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“Oracle”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 区域 选择区域。 项目 选择项目。 实例 选择实例，用于后续验证连通性。 连接与安全 选择数据库的连接模式。 默认：由系统根据用户配置自动拼接数据源连接字符串。 专业：由用户自己输入数据源连接字符串。 主机IP地址 仅当“连接与安全”选择“默认”时需要配置。 填写数据库的连接IP地址。 端口 仅当“连接与安全”选择“默认”时需要配置。 填写数据库的连接端口号。 数据库名 仅当“连接与安全”选择“默认”时需要配置。 填写要连接的数据库名。 编码格式 仅当“连接与安全”选择“默认”时需要配置。 填写数据库的编码格式。 超时时间 仅当“连接与安全”选择“默认”时需要配置。 填写连接数据库的超时时间。 连接字符串 仅当“连接与安全”选择“专业”时需要配置。 填写Oracle数据库的JDBC格式连接串，例如：jdbc:oracle:thin:@{hostname}:{port}:{dbname}。 用户名 连接数据库的用户名。 密码 连接数据库的用户密码。 描述 填写连接器的描述信息，用于识别不同的连接器。

支持的操作 获取分支目录下的文件；获取仓库统计数据；修改被流水线引用的仓库状态；判断用户是否有仓库的管理员权限；设置仓库是公开状态还是私有状态；获取一个项目下可以设置为公开状态的仓库列表；获取公开示例模板列表；获取项目下所有仓库信息；校验指定项目下的仓库名；创建仓库；根据仓库名组名获取仓库短id，用以拼接与commitid对应提交详情页面url；根据组名和仓库名查询某仓库某分支对应的提交；查询指定仓库的webhook；为指定仓库添加hook；删除指定仓库的 hook；查询某仓库对应的分支；根据仓库id查询仓库某分支对应的提交，提供更多可选参数；添加部署密钥；删除仓库部署密钥；获取仓库上一次的提交统计信息；仓库统计；查询项目下的某个仓库；删除仓库；获取仓库所有成员记录；添加仓库成员；设置成员在仓库中的角色；删除仓库成员；查看仓库的创建状态；https账号密码校验；获取ssh key列表；添加ssh key；检验私钥是否有拉取代码的权限；删除用户公钥；查询用户的所有仓库；创建项目、仓库；创建项目并fork仓库；查询项目下的所有仓库；查询某仓库的标签列表；新建标签；查询某个仓库的详细信息；查询某个仓库的提交信息；创建提交；查询某个仓库的特定提交信息；查询某个仓库的提交差异信息；查询某个仓库的文件信息；获取代码提交行数；下载仓库；新建保护分支；获取仓库分支列表；分支关联工作项；获取仓库合并请求列表；获取仓库合并请求详情。

创建CodeArts Repo连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“华为云服务”类别下的“CodeArts Repo”。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

配置参数 表1 获取记录 参数 说明 表名 选择要查询的数据库中的表名。 WHERE条件 填写要查询数据的条件值（注意值要用英文单引号包住）。 Order by字段 填写返回结果的排序字段。 Limit条数 填写返回结果的每页数据条数。 Offset偏移量 填写分页查询的偏移量。 表2 添加记录 参数 说明 表名 选择连接的数据库中要插入数据的表名。 插入数据 填写插入操作中目标字段的值（注意值要用英文单引号包住）。 表3 更新记录 参数 说明 表名 选择连接的数据库中要更新数据的表名。 更新数据 填写更新操作中目标字段的值（注意值要用英文单引号包住）。 WHERE条件 填写要更新数据的条件值（注意值要用英文单引号包住）。 表4 删除记录 参数 说明 表名 选择连接的数据库中要删除数据的表名。 WHERE条件 填写要删除数据的条件值（注意值要用英文单引号包住）。

创建Gauss 100连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“Gauss 100”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 区域 选择区域。 项目 选择项目。 实例 选择实例，用于后续验证连通性。 连接与安全 选择数据库的连接模式。 默认：由系统根据用户配置自动拼接数据源连接字符串。 专业：由用户自己输入数据源连接字符串。 版本号 选择Gauss 100版本号，当前支持“V100R003C20”和“V300R001C00”。 主机IP地址 仅当“连接与安全”选择“默认”时需要配置。 填写数据库的连接IP地址。 端口 仅当“连接与安全”选择“默认”时需要配置。 填写数据库的连接端口号。 数据库名 仅当“连接与安全”选择“默认”时需要配置。 填写要连接的数据库名。 连接字符串 仅当“连接与安全”选择“专业”时需要配置。 填写Gauss 100数据库的JDBC格式连接串，例如：jdbc:postgresql://host:port/dbname。 用户名 连接数据库的用户名。 密码 连接数据库的用户密码。 描述 填写连接器的描述信息，用于识别不同的连接器。

创建Sql Server连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“Sql Server”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 区域 选择区域。 项目 选择项目。 实例 选择实例，用于后续验证连通性。 连接与安全 选择数据库的连接模式。当前支持“默认”模式，由系统根据用户配置自动拼接数据源连接字符串。 默认：由系统根据用户配置自动拼接数据源连接字符串。 专业：由用户自己输入数据源连接字符串。 主机IP地址 仅当“连接与安全”选择“默认”时需要配置。 填写数据库的连接IP地址。 端口 仅当“连接与安全”选择“默认”时需要配置。 填写数据库的连接端口号。 数据库名 仅当“连接与安全”选择“默认”时需要配置。 填写要连接的数据库名。 连接字符串 仅当“连接与安全”选择“专业”时需要配置。 填写Sql Server数据库的JDBC格式连接串，例如：jdbc:sqlserver://{hostname}:{port};DatabaseName={dbname}。 用户名 连接数据库的用户名。 密码 连接数据库的用户密码。 描述 填写连接器的描述信息，用于识别不同的连接器。

配置参数 表1 获取记录 参数 说明 表名 选择或者填写要查询的数据库中的表名。 字段名 选择要查询数据表的字段名。 WHERE条件 配置要查询数据的条件值（注意值要用英文单引号包住）。 Order by字段 填写返回结果的排序字段。 Limit条数 填写返回结果的每页数据条数。 Offset偏移量 填写分页查询的偏移量。 表2 增量获取记录 参数 说明 表名 选择或者填写要增量获取记录的数据库中的表名。 字段名 选择要查询数据表的字段名。 WHERE条件 配置要查询数据的条件值（注意值要用英文单引号包住）。 Order by字段 填写返回结果的排序字段。 增量获取时区 增量数据获取开始时区。 增量获取时间戳字段 增量数据获取的时间戳字段。 增量获取时间戳初始值 增量数据获取的时间戳初始值。 重置增量获取时间初始值 选择是否开启重置增量获取时间初始值。 增量获取时间补偿(毫秒） 增量获取补偿增量迁移初始时间戳。 表3 添加记录 参数 说明 表名 选择或者填写数据库中要插入数据的表名。 插入数据 填写插入操作中目标字段的值（注意值要用英文单引号包住）。 表4 更新记录 参数 说明 表名 选择或者填写数据库中要更新数据的表名。 更新数据 填写更新操作中目标字段的值（注意值要用英文单引号包住）。 WHERE条件 配置要更新数据的条件值（注意值要用英文单引号包住）。 表5 同步数据 参数 说明 表名 选择或者填写数据库中要同步数据的表名。 清空表 每次同步数据，是否先清空表。 表6 删除记录 参数 说明 表名 选择或者填写数据库中要删除数据的表名。 WHERE条件 配置要删除数据的条件值（注意值要用英文单引号包住）。 表7 自定义SQL 参数 说明 执行语句 填写操作数据库的原生SQL语句。 执行语句内容会明文展示所输入信息，请防止信息泄露。 请谨慎使用drop、truncate等非查询类语句。

支持的动作 修改任务规则集 任务配置高级选项 查询任务检查失败日志 任务配置屏蔽目录 查询任务的高级选项 新建检查任务 查询任务规则集的检查参数 任务配置检查参数 设置每个项目对应语言的默认规则集配置 创建自定义规则集 查询规则集列表 查看规则集的规则列表 查询任务的已选规则集列表 删除自定义规则集 查询任务的已选规则集列表 获取规则列表接口 查询任务规则集的检查参数 终止检查任务 查询缺陷详情的统计 修改缺陷状态 查询任务执行状态 历史扫描结果查询 查询缺陷概要 查询cmertrics缺陷概要 查询缺陷详情 查询任务列表 执行检查任务 删除检查任务

创建CodeArts Check连接 登录新版ROMA Connect控制台。 在左侧导航栏选择“连接器”，在连接器页面单击“新建连接”。 选择“CodeArts Check”连接器。 在弹窗中配置连接器信息，完成后单击“确定”。 参数 说明 连接名称 填写连接器实例名称。 描述 填写连接器的描述信息，用于识别不同的连接器。 Access Key 当前账号的AK（Access Key ID）。请参考访问密钥获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。 Secret Access Key 当前账号的SK（Secret Access Key）。请参考访问密钥获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。

配置参数 表1 实时计算单个自定义报表 参数 说明 project_id 项目ID。 plan_id 分支/计划ID。 region_id 区域ID。 name 报表名称。 workpiece_type 工件类型（用例：case，测试套：suite）。 analysis_dim_row 分析维度。 compare_dim_column 对比维度。 creatorIds 创建人。 ownerIds 所属人。 ranks 级别。 releaseIds releaseId。 status 状态。 moduleIds 级别。 results 结果。 labelIds 标签。 startTime 开始时间。 endTime 结束时间。 isAssociateIssue 是否关联需求。 表2 查询某个测试计划下的需求树 参数 说明 project_id 项目ID。 plan_id 测试计划ID。 region_id 区域ID。 offset 起始偏移量。 limit 每页显示条目数量，最大支持200条。 表3 查询某测试计划下的操作历史 参数 说明 project_id 项目ID。 plan_id 测试计划ID。 region_id 区域ID。 offset 起始偏移量。 limit 每页显示的条目数量，最大支持200条。 表4 获取环境参数分组列表 参数 说明 project_id 项目ID。 region_id 区域ID。 offset 起始偏移量。 limit 每页显示的条目数量，最大支持200条。 表5 通过导入仓库中的文件生成接口测试套 参数 说明 project_id 项目ID。 region_id 区域ID。 testsuite_name 要生成的测试套名称。 repository_id 仓库ID。 repository_branch 仓库分支。 file_path 仓库中yaml或json文件的相对路径，仅支持Swagger 2.0版本的yaml和json文件。 表6 计划中批量添加测试用例 参数 说明 project_id 项目ID。 plan_id 计划ID。 region_id 区域ID。 service_id 注册测试类型服务接口返回的服务ID。 testcase_id_list 计划下包含的用例个数，数组长度小于50个，只能包含一种测试类型。 表7 项目下查询测试计划列表v2 参数 说明 project_id 项目ID。 region_id 区域ID。 offset 起始偏移量。 limit 每页显示的条目数量，最大支持200条。 name 针对测试计划名称模糊查询。 current_stage 测试计划所处截断（create,design,execute,report）。 表8 项目下创建计划 参数 说明 project_id 项目ID。 region_id 区域ID。 name 计划名称。 assigned_id 处理者ID。 service_id_list 计划下包含的用例类型，数组长度小于10。 start_date 计划开始时间，要求用UTC时间表示，如2020-03-04。 end_date 计划结束时间，要求用UTC时间表示，如2020-03-04。 表9 项目下查询测试计划列表 参数 说明 project_id 项目ID。 region_id 区域ID。 name 针对测试计划名称模糊查询使用。 current_stage 测试计划所处截断（create,design,execute,report）。 offset 页号，取值范围1-20000。 limit 每页显示条目数量，取值范围1-200。 表10 通过用例编号获取测试用例详情 参数 说明 project_id 项目ID。 region_id 区域ID。 testcase_number 用例编号。 表11 批量更新测试用例结果 参数 说明 project_id 项目ID。 region_id 区域ID。 service_id 注册测试类型服务接口返回的服务ID。 testcase_id 测试用例ID。 execute_id 注册服务执行ID。 result_id 测试用例结果，（0-成功，1-失败，5-执行中，6-停止）。 end_time 用例结束执行的时间戳，在执行结束时该字段必填。 duration 执行用例持续时长ms，更新状态时该字段必传。 description 用于记录该次结果执行的备注信息。 表12 批量执行测试用例 参数 说明 project_id 项目ID。 region_id 区域ID。 service_id 注册测试类型服务接口返回的服务ID。 plan_id 测试计划ID testcase_id 测试用例ID execute_id 注册服务执行ID。 result_id 测试用例结果（0-成功，1-失败，5-执行中，6-停止）。 start_time 用例开始执行的时间戳，在执行开始时该字段必填。 表13 更新自定义测试服务类型用例 参数 说明 project_id 项目ID。 testcase_id 测试用例ID。 region_id 区域ID。 name 页面上显示的用例名称。 service_id 注册测试类型服务接口返回的服务ID。 rank_id 测试用例等级，可选值为[0，1，2，3，4]，不填默认为2。 testcase_number 用例编号，不填时自动生成。 description 测试用例描述信息。 preparation 执行该测试用例时需要满足的前置条件。 expect_result 测试用例预期结果信息。 test_step 测试步骤描述信息。 label_list 标签名称列表。 module_id 模块号。 test_version_id 测试版本号。 fix_version_id 迭代号。 assigned_id 处理者ID信息。 issue_id 用例关联的需求ID信息。 status_id 测试用例状态信息（0-新建，5-设计中，6-测试中，7-完成）。 defect_id_list 缺陷ID信息。 表14 获取测试用例详情 参数 说明 project_id 项目ID。 testcase_id 测试用例ID。 region_id 区域ID。 表15 批量删除自定义测试服务类型用例 参数 说明 project_id 项目ID。 region_id 区域ID。 service_id 注册测试类型服务接口返回的服务ID。 test_case_id_list 测试用例ID。 表16 创建自定义测试服务类型用例 参数 说明 project_id 项目ID。 region_id 区域ID。 name 页面上显示的用例名称。 service_id 该值由注册接口返回。 rank_id 测试用例等级，可选值为[0，1，2，3，4]，不填默认为2。 testcase_number 用例编号，不填时自动生成。 description 测试用例描述信息。 preparation 执行该测试用例时需要满足的前置条件。 expect_result 测试用例预期结果信息。 test_step 测试步骤描述信息。 label_list 标签名称列表。 module_id 模块号。 test_version_id 测试版本号。 fix_version_id 迭代号。 assigned_id 处理者ID信息。 issue_id 用例关联的需求ID信息。 表17 删除已注册服务 参数 说明 service_id 注册服务ID，该值由注册接口返回。 region_id 区域ID。 表18 更新已注册服务 参数 说明 service_id 注册服务ID，该值由注册接口返回。 region_id 区域ID。 service_name 测试类型名称，用于界面显示，不能使用当前保留名。 server_host 域名，服务会通过此域名进行接口调用，以https/http开头，长度小于等于128位字符。TestHub将会通过此域名下的接口，保证服务数据与客户系统数据的一致性。 表19 新测试类型服务注册 参数 说明 region_id 区域ID。 service_name 测试类型名称，用于界面显示，不能使用当前保留名。 server_host 域名，服务会通过此域名进行接口调用，以https/http开头，长度小于等于128位字符。TestHub将会通过此域名下的接口，保证服务数据与客户系统数据的一致性。 表20 用户获取自己当前已经注册的服务 参数 说明 region_id 区域ID。