# 查询CES指定项目指定资源类型标签列表 - ListCesTargetProjectTags
#### 功能介绍
查询CES指定项目指定资源类型标签列表。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CES/doc?api=ListCesTargetProjectTags&version=v2)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-ces/ces_03_0045.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项           | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名                   | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | ces:tags:list | List | -           | -   | ces:projecttags:list | -      |
     
  
 
#### URI
GET /v2/{project_id}/{resource_type}/tags
表1路径参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| project_id    | 是    | String | **参数解释**: 项目ID。用于明确项目归属，配置后可通过该ID查询项目下资产，可以通过调用API获取，也可以从控制台获取。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-ces/ces_03_0057.html)。 **约束限制**: 不涉及。 **取值范围**: 字符串的长度必须在 1 到 64个字符之间。 **默认取值**: 不涉及。 |
| resource_type | 是    | String | **参数解释**： 资源类型。 **约束限制**： 不涉及。 **取值范围**： 只能为CES-alarm，代表告警规则。长度\[1,32\]个字符。长度1到32个字符。 **默认取值**： 不涉及。                                                                                                     |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| Content-Type | 否    | String | **参数解释**: 发送的实体的MIME类型。 **约束限制**: 不涉及。 **取值范围**: 最小字符数量为1，最大为64。 **默认取值**: 默认使用application/json; charset=UTF-8。                                                                            |
| X-Auth-Token | 否    | String | **参数解释**: 用户Token。Token认证，具体操作请参考[认证鉴权](https://support.huaweicloud.com/api-ces/ces_03_0011.html)。 **约束限制**: 不涉及。 **取值范围**: 最小字符数量为1，最大为16384。 **默认取值**: 不涉及。 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数   | 参数类型                                                                                                 | 描述                                                                                         |
|:---|:---|:---|
| tags | Array of [TagResp] objects | **参数解释**： 租户标签列表。 |
   
 表4TagResp 
| 参数     | 参数类型             | 描述                                                                                                                                                                                                                                                                     |
|:---|:---|:---|
| key    | String           | **参数解释**： 标签名。 **取值范围**： 最大长度128个unicode字符。 |
| values | Array of strings | **参数解释**： 标签值。                                                                                                                                                                                |
   
**状态码：404**
表5响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                                                                |
|:---|:---|:---|
| error_code | String | **参数解释**： 用于标识请求异常的具体原因。 **取值范围**： 字符串长度为0到256个字符。     |
| error_msg  | String | **参数解释**： 用于描述请求异常的具体信息。 **取值范围**： 字符串长度为0到256个字符。     |
| request_id | String | **参数解释**： 用于唯一标识一次请求，便于问题追踪。 **取值范围**： 字符串长度为0到256个字符。 |
   
#### 请求示例
请求样例：查询CES指定项目，资源类型为CES-alarm的标签列表
```
GET https://{云监控的endpoint}/v2/{project_id}/CES-alarm/tags
```
#### 响应示例
**状态码：200**
OK
```
{
  "tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  }, {
    "key" : "key2",
    "values" : [ "value1", "value2" ]
  } ]
}
```
#### 状态码
| 状态码 | 描述    |
|:---|:---|
| 200 | OK    |
| 404 | 资源未找到 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ces/ErrorCode.html)。