批量删除标签

功能介绍

为指定共享批量删除标签。

此接口为幂等接口：如果共享上不存在待删除的标签，则默认删除成功。

URI

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

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

请求消息头

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

请求消息

• 参数说明

  参数	是否必选	参数类型	描述
  action	是	String	操作标识，取值范围为：“create”和“delete”。 为指定共享批量删除标签时使用“delete”。
  tags	是	Array of resource_tags	标签列表。

• resource_tag字段说明：

  参数	是否必选	参数类型	描述
  key	是	String	标签的键。 最大长度36个字符。 key不能为空。
  value	否	String	标签的值。 每个值最大长度43个字符，可以为空字符串。 如果value有值，则按照key+value精确匹配删除对应的标签；如果value没值，则按照key删除。

• 请求样例
  批量删除标签，删除的第一个标签的键为“key1”，值为“value1”；第二个标签的键为“key2”；第三个标签的键为“key3”。

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

响应消息

• 参数说明

  无

• 响应样例

  无

状态码

• 正常

  204

• 异常

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