功能介绍
指定共享添加一个标签。
一个共享上最多有20个标签。
一个共享上的多个标签的key不允许重复。
此接口为幂等接口：如果要添加的key在共享上已存在，则覆盖更新标签。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
POST /v1/{project_id}/sfs-turbo/{share_id}/tags
表1 路径参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|
project_id |
是 |
String |
操作用户的项目ID |
|
share_id |
是 |
String |
共享ID |
请求参数
表3 请求Body参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|
tag |
是 |
ResourceTag object |
resource_tag字段说明 |
表4 ResourceTag
|
参数 |
是否必选 |
参数类型 |
描述 |
|
key |
是 |
String |
标签的键。
最大长度128个字符。
key不能为空，不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大写字母、小写字母、数字，特殊字符"-"和"_"。 |
|
value |
是 |
String |
标签的值。
每个值最大长度255个字符，可以为空字符串。
不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大写字母、小写字母、数字，特殊字符"-"和"_"。 |
响应参数
状态码：204
创建共享标签请求下发成功
无
请求示例
创建一个共享标签，标签的键为“key1”，标签的值为“value1”。
{
"tag" : {
"key" : "key1",
"value" : "value1"
}
}
