更新时间：2026-09-30 GMT+08:00

查询租户所有共享的标签 - ListSharedTags

查询租户所有共享的标签集合。

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

GET /v1/{project_id}/sfs-turbo/tags

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID，用于标识资源所属的IAM项目空间，实现项目级资源隔离与权限管控。获取方法请参见获取项目ID。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

表2 Query参数
参数	是否必选	参数类型	描述
limit	否	Integer	参数解释：返回的标签个数，用于控制每页返回的标签数量。约束限制：不涉及。取值范围： 0~1000的整数。默认取值： 1000
offset	否	Integer	参数解释：标签查询个数的偏移量，用于分页查询时指定起始位置。约束限制：不涉及。取值范围：大于等于0的整数。默认取值： 0

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token，用于鉴权认证。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
Content-Type	是	String	参数解释：请求消息体MIME类型，用于标识请求正文的数据格式。约束限制：不涉及。取值范围： application/json 默认取值： application/json

状态码：200

表4 响应Body参数
参数	参数类型	描述
tags	Array of Tag objects	参数解释：标签列表，每个元素包含标签的键和值列表。取值范围：不涉及。

表5 Tag
参数	参数类型	描述
key	String	参数解释：标签的键。取值范围：不涉及。
values	Array of strings	参数解释：值列表。取值范围：不涉及。

查询项目ID为"e1e45b08f3ea4480ab4655ef9c7160ba" 的所有文件系统的标签

GET HTTPS://{endpoint}/v1/e1e45b08f3ea4480ab4655ef9c7160ba/sfs-turbo/tags

状态码：200

{
  "tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "" ]
  }, {
    "key" : "key2",
    "values" : [ "value1", "value2" ]
  } ]
}

状态码	描述
200	查询成功，返回标签信息。

请参见错误码。

父主题： 共享标签