功能介绍
指定共享添加一个标签。 一个共享上最多有20个标签。 一个共享上的多个标签的key不允许重复。 此接口为幂等接口:如果要添加的key在共享上已存在,则覆盖更新标签。
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),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大写字母、小写字母、数字,特殊字符"-"和"_"。 最小长度:1 最大长度:128 |
value |
是 |
String |
标签的值。 每个值最大长度255个字符,可以为空字符串。 不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大写字母、小写字母、数字,特殊字符"-"和"_"。 最小长度:0 最大长度:255 |
请求示例
创建一个共享标签,标签的键为“key1”,标签的值为“value1”。
{
"tag" : {
"key" : "key1",
"value" : "value1"
}
}