文档首页/ 弹性文件服务 SFS/ API参考（联盟区域）/ SFS Turbo API说明/ 共享标签/ 删除共享标签
更新时间：2026-01-15 GMT+08:00
查看PDF
分享

删除共享标签

功能介绍

指定共享删除一个标签。当共享中不存在指定要删除的key时，接口调用将会返回404错误。

URI

DELETE /v1/{project_id}/sfs-turbo/{share_id}/tags/{key}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

操作用户的项目ID

share_id

是

String

共享ID

key

是

String

标签的键,最大长度128个字符。

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

说明：调用删除共享标签接口删除标签时，如果标签的键中存在不被URL直接解析的特殊字符，需要对标签的键进行URL转义处理。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型

响应参数

状态码：204

删除共享标签成功

无

请求示例

ID为"77ba6f4b-6365-4895-8dda-bc7142af4dde"的文件系统，删除key为test的标签

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

响应示例

无

状态码

状态码

描述

204

删除共享标签成功

错误码

请参见错误码。

父主题： 共享标签