批量添加标签

功能介绍

指定共享批量添加标签。

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

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

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

URI

• POST /v2/{project_id}/sfs/{share_id}/tags/action
• 参数说明

  参数	是否必选	参数类型	描述
  project_id	是	String	操作用户的项目ID，获取方法请参见获取项目ID。
  share_id	是	String	共享ID。

请求消息头

该操作消息头与普通请求一样，请参见表3。

请求消息

• 参数说明

  参数	是否必选	参数类型	描述
  action	是	String	操作标识，取值范围为：“create”和“delete”。 为指定共享批量添加标签时使用“create”。
  tags	否	Array of resource_tags	标签列表。 租户权限时该字段必选，op_service权限时和sys_tags二选一。
  sys_tags	否	Array of resource_tags	系统标签列表 op_service权限可以访问，和tags二选一。 目前TMS调用时只包含一个resource_tag结构体 ，key固定为：_sys_enterprise_project_id。 value是ID或0,value为0表示默认企业项目。

• resource_tag字段说明：

  参数	是否必选	参数类型	描述
  key	是	String	标签的键。最大长度36个字符。 key不能为空，不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。
  value	是	String	标签的值。每个值最大长度43个字符，可以为空字符串。 不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。

• 请求样例
  批量添加标签，第一个标签的键为“key1”，值为“value1”；第二个标签的键为“key2”，值为“value2”。

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

响应消息

• 参数说明

  无

• 响应样例

  无

状态码

• 正常

  204

• 异常

  状态码	说明
  400 Bad Request	无效输入。
  401 Unauthorized	鉴权失败。
  403 Forbidden	对被请求页面的访问被禁止。
  404 Not Found	资源未找到。
  500 Internal Server Error	请求未完成。服务异常。