# 查询tag列表 - ListTagList
#### 功能介绍
查询tag列表。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-codeci/cloudbuild_03_0007.html)。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /v1/code/tags
表1Query参数 
| 参数        | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| repo_id   | 否    | String  | **参数解释**： 代码仓ID，使用codehub必填。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。    |
| search    | 否    | String  | **参数解释**： 查询过滤条件。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。               |
| page_no   | 否    | Integer | **参数解释**： 分页页码，表示从此页开始查询。 **约束限制**： 正整数。 **取值范围**： page_no大于等于1。 **默认取值：** 1 |
| page_size | 否    | Integer | **参数解释**： 每页显示的条目数量。 **约束限制**： 正整数。 **取值范围**： page_size小于等于100。 **默认取值：** 10 |
| scm_type  | 是    | String  | **参数解释**： 代码源类型。 **约束限制**： 不涉及。 **取值范围**： codehub。 **默认取值**： 不涉及。            |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释**： 用户Token。（响应消息头中X-Subject-Token的值）。通过调用IAM服务接口获取，参考[获取IAM用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)。 **约束限制**： 不支持租户全局token，请使用scope为project的region级token。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数     | 参数类型   | 描述                                                                                                                                                                                           |
|:---|:---|:---|
| result | Object | **参数解释**： 调用接口成功后返回的数据。 **取值范围**： 不涉及。                                                          |
| status | String | **参数解释**： 返回状态信息。 **取值范围**： ● success：表示接口调用成功。 ● fail：表示接口调用失败。 |
   
表4result 
| 参数       | 参数类型                                                         | 描述                                                                                                                               |
|:---|:---|:---|
| total    | String                                                       | **参数解释**： 查询到tag的总数。 **取值范围**： 不涉及。 |
| tag_list | Array of [tag_list] objects | **参数解释**： tag集合。 **取值范围**： 不涉及。     |
   
 表5tag_list 
| 参数   | 参数类型   | 描述                                                                                                                           |
|:---|:---|:---|
| name | String | **参数解释**： tag名称。 **取值范围**： 不涉及。 |
   
#### 请求示例
```
GET https://{endpoint}/v1/code/tags?repo_id=2111668884&search=&scm_type=codehub&page_no=1
```
#### 响应示例
**状态码：200**
OK
```
{
  "result" : {
    "total" : 2,
    "tag_list" : [ {
      "name" : 1
    } ]
  },
  "status" : "success"
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-codeci/ErrorCode.html)。