
# 查询代码仓分支 - GetBranches
#### 功能介绍
根据详细筛选条件查询代码仓的分支
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-pipeline/pipeline_03_0006.html)。
#### URI
GET /v2/{cloud_project_id}/code/branches
表1路径参数 
| 参数               | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| cloud_project_id | 是    | String | **参数解释**： CodeArts项目的32位UUID，项目唯一标识。 **约束限制**： 不涉及。 **取值范围**： 32位字符。 **默认取值**： 不涉及。 |
   
表2Query参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| repoUrl      | 是    | String | **参数解释**： 代码仓url路径，通过流水线配置的代码仓获取。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                                                                                                           |
| authEndpoint | 否    | String | **参数解释**： 鉴权扩展点。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                                                                                                                            |
| repoId       | 否    | String | **参数解释**： repo代码仓id，通过流水线配置的代码仓获取。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                                                                                                          |
| pipelineId   | 否    | String | **参数解释**： 流水线ID，可以通过[查询流水线列表](https://support.huaweicloud.com/api-pipeline/ListPipelines.html)接口，其中pipelines.pipelineId即为流水线ID。 **约束限制**： 不涉及。 **取值范围**： 32位字符，仅由数字和字母组成。 **默认取值**： 不涉及。 |
| search       | 否    | String | **参数解释**： 查询关键字。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                                                                                                                            |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数       | 参数类型             | 描述                                                                                                                           |
|:---|:---|:---|
| \[数组元素\] | Array of strings | **参数解释**： 分支名列表。 **取值范围**： 不涉及。 |
   
#### 请求示例
```
GET https://{endpoint}/v2/532f1abd15fe42ce8fbc66e89a469b3e/code/branches?repoUrl=https%3A%2F%2Fcodehub.devcloud.xxx-7.ulanqab.huawei.com%2F532f1abd15fe42ce8fbc66e89a469b3e%2Ftujian_test.git&authEndpoint=&limit=30&offset=0&search=&repoId=2111929952&_=1763890872862
```
#### 响应示例
**状态码：200**
OK
```
[ {
  "name" : "asdfsadfasf"
}, {
  "name" : "codearts-pipeline"
}, {
  "name" : "dfgsdf"
}, {
  "name" : "test"
}, {
  "name" : "master"
}, {
  "name" : "tesat"
}, {
  "name" : "test_code_check"
} ]
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-pipeline/ErrorCode.html)。
