# 查询项目标签 - QueryingTagsofaSpecifiedProject
#### 功能介绍
查询指定项目的标签信息。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=GaussDBforNoSQL&api=ListInstanceTags)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-nosql/nosql_05_0023.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                       | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | gaussdbfornosql:tag:list | List                 | -                          | -                  | nosql:tag:list   | -    |
     
  
 
#### URI
GET /v3/{project_id}/tags
表1路径参数 
| 参数        | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释：** 租户在某一region下的project ID。获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-nosql/nosql_projectid.html)。 **约束限制：** 不涉及。 **取值范围：** 长度为32个字符，仅由英文字母和数字组成。 **默认取值：** 不涉及。 |
   
表2Query参数 
| 参数    | 是否必选 | 参数类型     | 描述                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| offset | 否      | Integer     | **参数解释：** 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询。 **约束限制：** 不能为负数。 **取值范围：** 不涉及。 **默认取值：** 0。 |
| limit    | 否      | Integer | **参数解释：** 查询个数上限值。 **约束限制：** 不涉及。 **取值范围：** 1\~100。 **默认取值：** 100。                |
   
#### 请求参数
表3请求Header参数 
| 参数             | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数         | 参数类型                                                        | 描述                                                                                                                                      |
|:---|:---|:---|
| tags    | Array of [Tag] objects | **参数解释：** 标签列表。详情见[Tag]表。                                       |
| total_count | Integer                                                     | **参数解释：** 总记录数。 **取值范围：** 不涉及。 |
   
 表5Tag 
| 参数   | 参数类型             | 描述                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| type  | String          | **参数解释：** 标签类型。 **取值范围：** - user：表示用户自定义标签。  - system：表示系统标签。   |
| key   | String           | **参数解释：** 标签键。 **取值范围：** 最大长度36个unicode字符，key不能为空。 字符集：0-9，A-Z，a-z，"_"，"-"，中文。                                                                                        |
| values | Array of strings | **参数解释：** 标签值列表。 每个标签值最大长度43个unicode字符，可以为空字符串。 字符集：0-9，A-Z，a-z，"_"，"."，"-"，中文。                                                                                                                   |
   
#### 请求示例
URI样例
```
GET https://{Endpoint}/v3/0549b4a43100d4f32f51c01c2fe4acdb/tags?offset=1&limit=10
```
#### 响应示例
**状态码： 200**
Success.
```
{ 
  "tags" : [ { 
    "key" : "key1", 
    "values" : [ "value1", "value2" ], 
    "type" : "user" 
  }, { 
    "key" : "key2", 
    "values" : [ "value1", "value2" ], 
    "type" : "system" 
  } ], 
  "total_count" : 2 
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-nosql/nosql_status_code.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-nosql/nosql_error_code.html)。