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

批量添加共享标签

功能介绍

指定共享批量添加标签。

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

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

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

share_id

是

String

共享ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

账号的token

Content-Type

是

String

MIME类型
表3 请求Body参数

参数

是否必选

参数类型

描述

action

是

String

操作标识，取值范围为：create。 为指定共享批量添加标签时使用create。

枚举值：

  • create

tags

是

Array of ResourceTag objects

标签列表。
表4 ResourceTag

参数

是否必选

参数类型

描述

key

是

String

标签的键。

最大长度128个字符。

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

value

是

String

标签的值。

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

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

响应参数

状态码：204

批量添加共享标签成功

无

请求示例

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

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

响应示例

无

状态码

状态码

描述

204

批量添加共享标签成功

错误码

请参见错误码。

父主题： 共享标签