# CodeArts Build
CodeArts Build连接器用于对接华为云CodeArts Build服务。
编译构建（CodeArts Build）基于云端大规模并发加速，为客户提供高速、低成本、配置简单的混合语言构建能力，帮助客户缩短构建时间，提升构建效率。
#### 前提条件
使用CodeArts Build前，需要开通CodeArts Build服务。
#### 创建CodeArts Build连接
1. 登录[CodeArts Link控制台](https://console.huaweicloud.com/codearts-link/)。
2. 在左侧导航栏选择"连接器"，在连接器页面单击"新建连接"。
3. 选择"CodeArts Build"连接器。
4. 在弹窗中配置连接器信息，完成后单击"确定"。
| 参数                | 说明                                                                                                                                                         |
|:---|:---|
| 连接名称              | 填写连接器实例名称。                                                                                                                                                 |
| 描述                | 填写连接器的描述信息，用于识别不同的连接器。                                                                                                                                     |
| Access Key        | 当前账号的AK（Access Key ID）。请参考[访问密钥](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html)获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。    |
| Secret Access Key | 当前账号的SK（Secret Access Key）。请参考[访问密钥](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html)获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。 |
   
#### 支持的动作
- 查询指定代码仓库最近一次成功的构建历史
- 获取构建历史详情信息接口
- 执行构建任务
- 根据开始时间和结束时间查看构建任务的构建成功率
- 查看任务运行状态
- 查看项目下用户的构建任务列表
- KeyStore文件下载
- 根据开始时间和结束时间查看构建任务的构建历史列表
- 查看构建任务的构建历史列表
 
#### 配置参数
表1查询指定代码仓库最近一次成功的构建历史 
| 参数              | 说明           |
|:---|:---|
| project_id      | 项目ID。        |
| region_id       | 区域ID。        |
| repository_name | 代码仓库名，不支持中文。 |
   
表2获取构建历史详情信息接口 
| 参数           | 说明                                       |
|:---|:---|
| job_id       | 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 |
| build_number | 构建任务的构建编号，从1开始，每次构建递增1。                  |
| region_id    | 区域ID。                                    |
   
表3执行构建任务 
| 参数        | 说明       |
|:---|:---|
| region_id | 区域ID。    |
| body      | 输入请求体内容。 |
   
表4根据开始时间和结束时间查看构建任务的构建成功率 
| 参数         | 说明                                       |
|:---|:---|
| job_id     | 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 |
| region_id  | 区域ID。                                    |
| start_time | 区间开始时间，格式yyyy-MM-dd。                     |
| end_time   | 区间结束时间，格式yyyy-MM-dd。                     |
   
表5查看任务运行状态 
| 参数        | 说明                                       |
|:---|:---|
| job_id    | 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 |
| region_id | 区域ID。                                    |
   
表6查看项目下用户的构建任务列表 
| 参数         | 说明                                |
|:---|:---|
| project_id | 项目ID。                             |
| region_id  | 区域ID。                             |
| page_index | 分页页码， 表示从此页开始查询， page_index大于等于0。 |
| page_size  | 每页显示的条目数量，page_size小于等于100。       |
   
表7KeyStore文件下载 
| 参数        | 说明                 |
|:---|:---|
| region_id | 区域ID。              |
| file_name | 下载的文件名称。           |
| domain_id | 租户ID。32位数字、小写字母组合。 |
   
表8根据开始时间和结束时间查看构建任务的构建历史列表 
| 参数         | 说明                                       |
|:---|:---|
| job_id     | 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 |
| region_id  | 区域ID。                                    |
| offset     | 分页页码， 表示从此页开始查询， offset大于等于0。            |
| limit      | 每页显示的条目数量，limit小于等于100。                  |
| start_time | 区间开始时间，格式yyyy-MM-dd。开始时间和结束时间间隔不能超过30天。  |
| end_time   | 区间结束时间，格式yyyy-MM-dd。开始时间和结束时间间隔不能超过30天。  |
   
表9查看构建任务的构建历史列表 
| 参数        | 说明                                       |
|:---|:---|
| job_id    | 构建的任务ID。编辑构建任务时，浏览器URL末尾的32位数字、字母组合的字符串。 |
| region_id | 区域ID。                                    |
| offset    | 分页页码， 表示从此页开始查询， offset大于等于0。            |
| limit     | 每页显示的条目数量，limit小于等于100。                  |
| interval  | 距今天的时间区间（单位：天），interval小于等于30。           |