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

查询共享标签 - ShowSharedTags

查询指定共享的所有标签信息。

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

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

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

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

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

状态码：200

表3 响应Body参数
参数	参数类型	描述
tags	Array of ResourceTag objects	参数解释：标签列表，每个元素为一个标签键值对。取值范围：不涉及。

表4 ResourceTag
参数	参数类型	描述
key	String	参数解释：标签的键。取值范围：不涉及。
value	String	参数解释：标签的值。取值范围：不涉及。

ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde"的文件系统，查询标签

GET HTTPS://{endpoint}/v1/{project_id}/sfs-turbo/77ba6f4b-6365-4895-8dda-bc7142af4dde/tags

状态码：200

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

状态码	描述
200	查询指定共享的所有标签的返回信息

请参见错误码。

父主题： 共享标签