更新时间:2022-02-24 GMT+08:00
分享

批量添加共享标签

功能介绍

指定共享批量添加标签。

一个共享上最多有10个标签。 一个共享上的多个标签的key不允许重复。 此接口为幂等接口:如果要添加的key在共享上已存在,则覆盖更新标签。

调试

您可以在API Explorer中调试该接口。

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

标签列表。 用户权限时该字段必选,op_service权限时和sys_tags二选一。

sys_tags

Array of ResourceTag objects

系统标签列表。 op_service权限可以访问,和tags二选一。目前TMS调用时只包含一个resource_tag结构体,key固定为:_sys_enterprise_project_id。

表4 ResourceTag

参数

是否必选

参数类型

描述

key

String

标签的键。

最大长度36个字符。

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

最小长度:1

最大长度:36

value

String

标签的值。

每个值最大长度43个字符,可以为空字符串。

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

最小长度:0

最大长度:43

响应参数

请求示例

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

响应示例

状态码

状态码

描述

204

批量添加共享标签成功

错误码

请参见错误码

分享:

    相关文档

    相关产品

关闭导读