文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 用例的关联关系管理/ 添加一个用例和多个需求/缺陷关联关系
更新时间:2025-07-24 GMT+08:00
分享

添加一个用例和多个需求/缺陷关联关系

功能介绍

添加一个用例和多个需求/缺陷关联关系

调用方法

请参见如何调用API

URI

POST /v4/testcases/{case_uri}/relations

表1 路径参数

参数

是否必选

参数类型

描述

case_uri

String

用例uri

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

relations

Array of RelationInfo objects

参数解释

关联关系

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

tracker_id

String

参数解释

工作项类型id

约束限制

1到20位数字

取值范围

不涉及

默认取值

不涉及

version_uri

String

参数解释

版本uri

约束限制

11到34位英文或数字

取值范围

不涉及

默认取值

不涉及

task_uri

String

参数解释

测试套id

约束限制

11到34位英文或数字

取值范围

不涉及

默认取值

不涉及

add_to_iterator

Boolean

参数解释

是否将需求添加到迭代

约束限制

11到34位英文或数字

取值范围

不涉及

默认取值

不涉及

project_uuid

String

参数解释

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

约束限制

不涉及

取值范围

项目uuid应符合如下规则:长度等于32位,包含大小写字母、数字

默认取值

不涉及

表3 RelationInfo

参数

是否必选

参数类型

描述

dr_number

String

参数解释

需求id

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

test_case_uri

String

参数解释

用例uri

约束限制

不涉及

取值范围

11到34位英文或数字

默认取值

不涉及

relate_type

String

参数解释

资源类型

约束限制

不涉及

取值范围

bug/requirement

默认取值

不涉及

resource_type

String

参数解释

资源类型

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

source_system

String

参数解释

来源系统

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

association_number

String

参数解释

关联资源编号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

region

String

参数解释

逻辑region,外部使用公有云实际区域,内部使用默认值

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

status

String

参数解释:

本次请求的处理状态

取值范围:

success|error

result

ResultValueString object

参数解释:

请求结果

取值范围:

非必返

error

ApiError object

参数解释:

错误信息

取值范围:

非必返

request_id

String

参数解释:

请求的唯一id

取值范围:

非必返

address

String

参数解释:

本次请求的受理的服务地址。

取值范围:

非必返

表5 ResultValueString

参数

参数类型

描述

value

String

参数解释

resultObject

取值范围

不涉及

表6 ApiError

参数

参数类型

描述

code

String

参数解释:

业务失败的错误码

取值范围:

不涉及

reason

String

参数解释:

业务失败的提示内容

取值范围:

不涉及

状态码:400

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:401

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:404

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:500

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

post https://{endpoint}/v4/testcases/v92s00010hovqddt/relations

{
  "relations" : [ {
    "dr_number" : "3325606",
    "test_case_uri" : "223685",
    "relate_type" : "bug/requirement",
    "resource_type" : "testcase/testitem",
    "source_system" : "vision",
    "association_number" : "223685",
    "region" : "szv"
  } ],
  "tracker_id" : "1",
  "version_uri" : "932opbu6aaf",
  "task_uri" : "59281152185",
  "add_to_iterator" : true,
  "project_uuid" : "223685eqweqwe1112w"
}

响应示例

状态码:200

OK

{
  "status" : "success",
  "result" : {
    "value" : "success"
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档