功能介绍
指定共享添加一个标签。
一个共享上最多有20个标签。
一个共享上的多个标签的key不允许重复。
此接口为幂等接口:如果要添加的key在共享上已存在,则覆盖更新标签。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有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),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大写字母、小写字母、数字,特殊字符"-"和"_"。 |
请求示例
创建一个共享标签,标签的键为“key1”,标签的值为“value1”。
{
"tag" : {
"key" : "key1",
"value" : "value1"
}
}