新建检查任务
功能介绍
新建检查任务但是不执行。
调用方法
请参见如何调用API。
URI
POST /v2/{project_id}/task
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 项目的32位uuid,项目唯一标识,通过查询项目列表接口查询项目列表获取。 约束限制: 不涉及。 取值范围: 32位项目ID。 默认取值: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 字符串长度不少于1,不超过10万。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
|
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。 约束限制: 32位UUID。 取值范围: 不涉及。 默认取值: 语言在项目下的默认规则集。 |
|
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标题。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
task_id |
String |
参数解释: 任务ID。 取值范围: 全量任务为32位UUID,MR增量任务为"MR_"+32位UUID。 |
状态码:400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误描述 |
状态码:401
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码 |
|
error_msg |
String |
错误描述 |
请求示例
新建检查任务:检查任务的检查类型为source,对应代码仓URL根据实际情况显示,代码仓分支为master,语言类型为cpp
POST https://{endpoint}/v2/{project_id}/task
{
"git_url" : "git@code*****************958.git",
"git_branch" : "master",
"language" : [ "cpp", "js" ]
}
响应示例
状态码:200
Request succeeded!
{
"task_id" : "d161fd0**********cb3c1d6a783e"
}
状态码:400
Bad Request
{
"error_code" : "CC.00000000",
"error_msg" : "网络繁忙,请稍后再试"
}
状态码:401
Unauthorized
{
"error_code" : "CC.00000003",
"error_msg" : "认证信息过期"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
Request succeeded! |
|
400 |
Bad Request |
|
401 |
Unauthorized |
错误码
请参见错误码。