文档首页/ 高性能弹性文件服务 SFS Turbo/ API参考/ API/ 共享标签/ 查询共享标签 - ShowSharedTags
更新时间：2026-03-02 GMT+08:00
查看PDF
分享

查询共享标签 - ShowSharedTags

功能介绍

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

授权信息

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

操作用户的项目ID

share_id

是

String

共享ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

tags

Array of ResourceTag objects

tag标签的列表。
表4 ResourceTag

参数

参数类型

描述

key

String

标签的键。

最大长度128个字符。

key不能为空，不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大写字母、小写字母、数字，特殊字符"-"和"_"。

value

String

标签的值。

每个值最大长度255个字符，可以为空字符串。

不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大写字母、小写字母、数字，特殊字符"-"和"_"。

请求示例

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

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

响应示例

状态码：200

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

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

状态码

状态码

描述

200

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

错误码

请参见错误码。

父主题： 共享标签