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

批量添加共享标签 - BatchAddSharedTags

指定共享批量添加标签。

一个共享上最多有20个标签。

一个共享上的多个标签的key不允许重复。

此接口为幂等接口：如果要添加的key在共享上已存在，则覆盖更新标签。

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

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

POST /v1/{project_id}/sfs-turbo/{share_id}/tags/action

表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

表3 请求Body参数
参数	是否必选	参数类型	描述
action	是	String	参数解释：操作标识，用于指定批量添加标签的操作类型。约束限制：不涉及。取值范围： create 默认取值：不涉及。
tags	是	Array of ResourceTag objects	参数解释：标签列表，每个元素为一个标签键值对。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

表4 ResourceTag
参数	是否必选	参数类型	描述
key	是	String	参数解释：标签的键。约束限制：键不能为空。键最大长度为128个字符。只能包含大写字母、小写字母、数字以及特殊字符“-”和“_”，不能包含非打印字符（ASCII 0~31）及“=”，“”，“<”，“>”，“\”，“，”，“\|”，“/”。取值范围：* 不涉及。默认取值：不涉及。
value	是	String	参数解释：标签的值。约束限制：值最大长度为255个字符，可以为空字符串。最多包含20个键，每个键最多对应20个值。只能包含大写字母、小写字母、数字以及特殊字符“-”和“_”，不能包含非打印字符（ASCII 0~31）及“=”, “”, “<”, “>”, “\”, “,”, “\|”, “/”。取值范围：* 不涉及。默认取值：不涉及。

状态码：204

无

批量添加共享标签，第一个标签的键为“key1”，值为“value1”；第二个标签的键为“key2”，值为“value1”。

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

无

状态码	描述
204	批量添加共享标签成功

请参见错误码。

父主题： 共享标签