
# 查询项目标签 - ListTagsByProject
#### 功能介绍
查询租户在指定Project中所有资源的标签集合。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfs/sfs_02_0079.html)。
#### 接口约束
如果您将标签权限限制在某个企业项目中，将无法访问TMS平台，查询项目标签时会失败。
#### URI
- GET /v3/sfs/tms/{project_id}/file-systems/tags
- 参数说明
  
  | 参数         | 是否必选 | 参数类型   | 描述                                                                                   |
  |:---|:---|:---|:---|
  | project_id | 是    | String | 操作用户的项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-sfs/sfs_02_0090.html)。 |
     
  
 
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                          |
|:---|:---|:---|:---|
| Content-type | 是    | String | 发送的实体的MIME类型。 示例：application/json。 |
| X-Auth-Token | 否    | String | 用户Token。                                                                                                                    |
   
#### 响应参数
表2响应body参数 
| 参数   | 是否必选 | 参数类型                                                                                                   | 描述                                                                                                        |
|:---|:---|:---|:---|
| tags | 是    | List\<[tag](https://support.huaweicloud.com/api-sfs/sfs_03_0005.html#sfs_03_0005__table138157172456)\> | 标签列表。详细说明参见[表3](https://support.huaweicloud.com/api-sfs/sfs_03_0005.html#sfs_03_0005__table138157172456)。 |
   
#### 请求示例
projectId为"c80a2157ba1d46c0825265947342077c"，查询项目标签示例：
```
GET https://{endpoint}/v3/sfs/tms/c80a2157ba1d46c0825265947342077c/file-systems/tags
```
#### 响应示例
```
{
    "tags":[
        {
            "key":"key1",
            "values":[
                "value1",
                "value2"
            ]
        },
        {
            "key":"key2",
            "values":[
                "value1",
                "value2"
            ]
        }
    ]
}
```
#### 状态码
- 正常
| 状态码 | 描述        |
|:---|:---|
| 200 | 查询项目标签成功。 |
   
- 异常
| 状态码 | 描述       |
|:---|:---|
| 400 | 标签等参数非法。 |
| 401 | 认证失败。    |
| 403 | 鉴权失败。    |
| 404 | 资源未找到。   |
| 500 | 系统异常。    |
   
