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

删除共享标签 - DeleteSharedTag

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

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

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

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID，用于标识资源所属的IAM项目空间，实现项目级资源隔离与权限管控。获取方法请参见获取项目ID。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
share_id	是	String	参数解释：文件系统ID，用于唯一标识SFS Turbo文件系统实例。获取方法请参见查询文件系统列表接口。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
key	是	String	参数解释：标签的键。约束限制：键不能为空。键最大长度为128个字符。只能包含大写字母、小写字母、数字以及特殊字符“-”和“_”，不能包含非打印字符（ASCII 0~31）及“=”，“”，“<”，“>”，“\”，“，”，“\|”，“/”。如果键中存在不被URL直接解析的特殊字符，需对键进行URL转义处理。取值范围：* 不涉及。默认取值：不涉及。

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

状态码：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	删除共享标签成功

请参见错误码。

父主题： 共享标签