功能介绍
指定共享添加一个标签。
一个共享上最多有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，用于标识资源所属的IAM项目空间，实现项目级资源隔离与权限管控。 获取方法请参见获取项目ID。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
| share_id | 是 | String | 参数解释： 文件系统ID，用于唯一标识SFS Turbo文件系统实例。 获取方法请参见查询文件系统列表接口。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
请求参数
表3 请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 |
| tag | 是 | ResourceTag object | 参数解释： 创建共享标签请求体，包含需要添加的标签键值对信息。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 |
表4 ResourceTag | 参数 | 是否必选 | 参数类型 | 描述 |
| key | 是 | String | 参数解释： 标签的键。 约束限制： 取值范围： 不涉及。 默认取值： 不涉及。 |
| value | 是 | String | 参数解释： 标签的值。 约束限制： -
值最大长度为255个字符，可以为空字符串。 -
最多包含20个键，每个键最多对应20个值。 -
只能包含大写字母、小写字母、数字以及特殊字符“-”和“_”，不能包含非打印字符（ASCII 0~31）及“=”, “*”, “<”, “>”, “\”, “,”, “|”, “/”。 取值范围： 不涉及。 默认取值： 不涉及。 |
请求示例
创建一个共享标签，标签的键为“key1”，标签的值为“value1”。
{
"tag" : {
"key" : "key1",
"value" : "value1"
}
} 
