文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 功能自动化任务管理/ 拷贝任务组模板 - copyTaskGroupUsingPOST
更新时间：2026-07-07 GMT+08:00
在线调试
CLI示例
查看PDF
分享

拷贝任务组模板 - copyTaskGroupUsingPOST

功能介绍

拷贝指定的功能自动化任务组模板

调用方法

请参见如何调用API。

URI

POST /attask/v1/taskgroup/copy

请求参数

表1 请求Header参数

参数

是否必选

参数类型

描述

x-auth-tenantid

是

String

参数解释

租户id

约束限制

不涉及

取值范围

字符串长度不少于1，不超过100000

默认取值

不涉及

获取方式

从 GET /rest/me 的返回结果中对应的id字段获取。

x-auth-groups

是

String

参数解释

项目id

约束限制

不涉及

取值范围

字符串长度不少于1，不超过100000

默认取值

不涉及

获取方式

从 GET /rest/me 的返回结果中对应的id字段获取。

x-user-name

是

String

参数解释

用户id

约束限制

不涉及

取值范围

字符串长度不少于1，不超过100000

默认取值

不涉及

获取方式

从 GET /rest/me 的返回结果中对应的id字段获取。

x-auth-token

是

String

参数解释：

用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

必传。

取值范围：

字符串长度不少于1，不超过10万。

默认取值：

不涉及。
表2 请求Body参数

参数

是否必选

参数类型

描述

[数组元素]

否

Array of TaskGroup objects

任务列表
表3 TaskGroup

参数

是否必选

参数类型

描述

taskId

否

String

参数解释

任务ID

获取方式

从 POST /v3/task/list 返回结果中对应的id字段获取。

srcVersionUri

否

String

源版本地址

srcServiceId

否

String

参数解释

源服务ID

获取方式

从 GET /rest/me 返回结果中的 projectId 字段获取。

destVersionUri

否

String

目标版本地址

destVersionName

否

String

目标版本名称

destServiceId

否

String

参数解释

目标服务ID

获取方式

从 GET /rest/me 返回结果中的 projectId 字段获取。

isSameBranch

否

Boolean

是否相同分支

iter2branch

否

Boolean

是否从迭代复制到分支

versionInfo

否

versionInfo object

版本信息

override_duplicate_aw

否

Boolean

是否

isCopyCase

否

Boolean

是否拷贝用例

taskName

否

String

任务名称

is_covered

否

Boolean

是否覆盖
表4 versionInfo

参数

是否必选

参数类型

描述

srcVersionInfo

否

srcVersionInfo object

源版本

destVersionInfo

否

destVersionInfo object

目标版本信息
表5 srcVersionInfo

参数

是否必选

参数类型

描述

branchUri

否

String

分支地址

branchName

否

String

分支名称
表6 destVersionInfo

参数

是否必选

参数类型

描述

branchUri

否

String

分支地址

branchName

否

String

分支名称

响应参数

状态码：200

表7 响应Body参数

参数

参数类型

描述

status

String

请求状态：OK - 成功

result

Object

返回结果

request_id

String

请求id

server_ip

String

服务节点IP

状态码：201

Created

状态码：401

表8 响应Body参数

参数

参数类型

描述

status

String

请求状态："failed" - 失败

request_id

String

请求id

server_ip

String

服务节点IP

error_msg

String

错误信息

error_code

String

错误码

error_cause

String

错误原因

faq

String

faq内容

状态码：403

表9 响应Body参数

参数

参数类型

描述

status

String

请求状态："failed" - 失败

request_id

String

请求id

server_ip

String

服务节点IP

error_msg

String

错误信息

error_code

String

错误码

error_cause

String

错误原因

faq

String

faq内容

状态码：404

表10 响应Body参数

参数

参数类型

描述

status

String

请求状态："failed" - 失败

request_id

String

请求id

server_ip

String

服务节点IP

error_msg

String

错误信息

error_code

String

错误码

error_cause

String

错误原因

faq

String

faq内容

请求示例

https://{endpoint}/attask/v1/taskgroup/copy

[ {
  "taskId" : "2842592082248335360",
  "srcVersionUri" : "v92u000107k90tfa",
  "srcServiceId" : "919992d350be469b85bfca4af6955cb6",
  "destVersionUri" : "v92u000107k90tfa",
  "destVersionName" : "基线",
  "destServiceId" : "919992d350be469b85bfca4af6955cb6",
  "isSameBranch" : true,
  "iter2branch" : false,
  "versionInfo" : {
    "srcVersionInfo" : {
      "branchUri" : "v92u000107k90tfa",
      "branchName" : "基线"
    },
    "destVersionInfo" : {
      "branchUri" : "v92u000107k90tfa",
      "branchName" : "基线"
    }
  },
  "override_duplicate_aw" : true,
  "isCopyCase" : true,
  "taskName" : "grouptaskbbq2_copy_20250815155802_copy_20250818095300",
  "is_covered" : false
} ]

响应示例

状态码：200

OK

{
  "status" : "OK",
  "result" : { },
  "request_id" : "adas23123412asdsac213",
  "server_ip" : "10.213.23.1"
}

状态码：401

Unauthorized

{
  "error_code" : "DEV.00000003",
  "error_msg" : "认证信息过期"
}

状态码

状态码

描述

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码。

相关文档