新建检查任务 - CreateTaskV2

project_id

是

String

参数解释：

项目的32位UUID，项目唯一标识，通过查询项目列表接口获取。

约束限制：

不涉及。

取值范围：

长度为[1~32]个字符。

默认取值：

不涉及。

X-Auth-Token

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

长度为[1~100000]个字符。

默认取值：

不涉及。

Content-Type

否

String

参数解释：

设置媒体类型和编码格式。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

application/json;charset=UTF-8

git_url

是

String

参数解释：

代码仓地址。

约束限制：

不涉及。

取值范围：

repo仓传以git开头的地址；非repo仓传以http开头的地址。

默认取值：

不涉及。

git_branch

是

String

参数解释：

计划创建任务的对应代码仓的分支。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

language

否

Array of strings

参数解释：

启用的检查语言，数组格式，支持的语言请关注服务更新特性文档。

约束限制：

与rule_sets 2选1使用。

取值范围：

不涉及。

默认取值：

不涉及。

rule_sets

否

Array of RuleSetV2 objects

参数解释：

启用的规则集，数组格式，当只传语言，不传规则集ID时，与language参数等效，启用这些语言在项目下的默认规则集，支持的语言请关注服务更新特性文档。

约束限制：

与language 2选1使用。

task_type

否

String

参数解释：

任务类型。

约束限制：

不涉及。

取值范围：

• full：代码仓分支对应的全量任务。

• inc：MR增量任务。

默认取值：

full

username

否

String

参数解释：

用户名，与access_token联合使用，用于在创建三方仓时，由Check服务创建1个通用git扩展点，从而保存代码仓信息。

约束限制：

username、access_token组合与endpoint_id 2选1使用。

取值范围：

不涉及。

默认取值：

不涉及。

access_token

否

String

参数解释：

密码或访问密钥/令牌，username，用于在创建三方仓时，由Check服务创建1个通用git扩展点，从而保存代码仓信息。

约束限制：

username、access_token组合与endpoint_id 2选1使用。

取值范围：

不涉及。

默认取值：

不涉及。

endpoint_id

否

String

参数解释：

用户预先创建的项目下的代码源扩展点ID，保存了代码仓信息。创建第三方代码源任务，若未填写endpoint，会自动创建扩展点，需要账号有创建扩展点权限，且项目下扩展点未达到上限。

约束限制：

username、access_token组合与endpoint_id 2选1使用。

取值范围：

不涉及。

默认取值：

不涉及。

inc_config

否

IncConfigV2 object

参数解释：

基于某一任务创建分支任务、MR任务时使用的参数。

约束限制：

不涉及。

resource_pool_id

否

String

参数解释：

用户购买的资源池ID，创建任务时如传此参数，任务将使用对应资源池进行检查。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

ruleset_id

否

String

参数解释：

规则集ID。

约束限制:

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

取值范围：

不涉及。

默认取值：

语言在项目下的默认规则集。

language

是

String

参数解释：

检查语言，支持的语言请关注服务更新特性文档。

约束限制:

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

parent_task_id

否

String

参数解释：

需要关联的任务ID。

约束限制：

32位UUID。

取值范围：

不涉及。

默认取值：

不涉及。

git_source_branch

否

String

参数解释：

MR增量任务的源分支。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

git_target_branch

否

String

参数解释：

MR增量任务的目标分支。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

merge_id

否

String

参数解释：

MR编号。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

event_type

否

String

参数解释：

创建MR增量任务时需传。

约束限制：

不涉及。

取值范围：

merge_request。

默认取值：

不涉及。

action

否

String

参数解释：

创建MR增量任务时需传。

约束限制：

不涉及。

取值范围：

open。

默认取值：

不涉及。

title

否

String

参数解释：

创建MR增量任务时需传，MR标题。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

task_id

String

参数解释：

任务ID。

取值范围：

全量任务为32位UUID，MR增量任务为"MR_"+32位UUID。

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误描述。

取值范围：

不涉及。

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误描述。

取值范围：

不涉及。

200

Request succeeded!

400

Bad Request

401

Unauthorized