添加共享标签

功能介绍

指定共享添加一个标签。

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

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

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

URI

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

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

请求消息头

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

请求消息

• 参数说明

  参数	是否必选	参数类型	描述
  tag	是	Resource_tag	标签。

• resource_tag字段说明：

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

• 请求样例
  添加共享标签，标签的键为“key1”，标签的值为“value1”。

  {
    "tag" : {
      "key" : "key1",
      "value" : "value1"
    }
  }

响应消息

• 要说明

  无

• 响应样例

  无

状态码

• 正常

  204

• 异常

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