# 查询集群标签列表 - ListClustersLabels
#### 功能介绍
查询指定K8s集群的所有标签信息。
#### URI
GET /v1/clusters/labels
表1Query参数 
| 参数             | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| k8s_cluster_id | 是    | String  | **参数解释** K8s集群ID，用于唯一标识一个K8s集群。 **约束限制** 不涉及。 **取值范围** 必须符合UUID格式，包含32个十六进制字符，被连字符分为5组，格式为8-4-4-4-12。 **默认取值** 不涉及。 |
| limit          | 否    | Integer | **参数解释** 返回结果数量限制，用于控制每次查询返回的标签数量。 **约束限制** 不涉及。 **取值范围** 最小值为1，最大值为2000。 **默认取值** 2000。                            |
| offset         | 否    | Integer | **参数解释** 偏移量，用于分页查询，从第offset+1条记录开始返回结果。 **约束限制** 不涉及。 **取值范围** 最小值为0，最大值为2000。 **默认取值** 0。                         |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数     | 参数类型                                                   | 描述                                                                                                                                                               |
|:---|:---|:---|
| total  | Integer                                                | **参数解释** 满足查询条件的总标签数量。 **取值范围** 最小值为0，最大值为2147483647。               |
| labels | Array of [Label] objects | **参数解释** 集群标签列表，包含符合条件的所有标签信息。 **取值范围** 最小元素个数为0，最大元素个数为2147483647。 |
   
 表3Label 
| 参数    | 参数类型   | 描述                                                                                                                                                            |
|:---|:---|:---|
| key   | String | **参数解释** 标签的键。 **取值范围** 由字母、数字、中划线(-)组成，长度范围1-63字节，且不能以中划线(-)结尾。 |
| value | String | **参数解释** 标签的值。 **取值范围** 长度范围最多支持63个字符。                           |
   
**状态码：400**
表4响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                    |
|:---|:---|:---|
| error_code | String | **参数解释** 错误码，用于标识具体的错误类型。 **取值范围** 不涉及。  |
| error_msg  | String | **参数解释** 错误描述，用于说明具体的错误信息。 **取值范围** 不涉及。 |
   
#### 请求示例
查询集群标签列表，每页返回10个记录，从第2条记录（offset=1）开始返回结果，cce集群ID为"7835613c-1b94-11f1-855e-0255ac1001bd"。
```
GET https://{endpoint}/v1/clusters/labels?limit=10&offset=1&k8s_cluster_id=7835613c-1b94-11f1-855e-0255ac1001bd
```
#### 响应示例
**状态码：200**
**参数解释**
成功返回集群标签列表。
**取值范围**
不涉及。
```
{
  "total" : 1,
  "labels" : [ {
    "key" : "ems",
    "value" : "true"
  } ]
}
```
**状态码：400**
**参数解释**
错误响应体。
**取值范围**
不涉及。
```
{
  "error_code" : "EMS.00004000",
  "error_msg" : "invalid parameter"
}
```
#### 状态码
| 状态码 | 描述                                                                                                                              |
|:---|:---|
| 200 | **参数解释** 成功返回集群标签列表。 **取值范围** 不涉及。 |
| 400 | **参数解释** 错误响应体。 **取值范围** 不涉及。      |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ems/ems_04_0031.html)。