# 创建共享标签 - CreateSharedTag
#### 功能介绍
指定共享添加一个标签。
一个共享上最多有20个标签。
一个共享上的多个标签的key不允许重复。
此接口为幂等接口：如果要添加的key在共享上已存在，则覆盖更新标签。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/SFSTurbo/doc?api=CreateSharedTag)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfsturbo/sfsturbo_02_0079.html)。
#### URI
POST /v1/{project_id}/sfs-turbo/{share_id}/tags
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述        |
|:---|:---|:---|:---|
| project_id | 是    | String | 操作用户的项目ID |
| share_id   | 是    | String | 共享ID      |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述       |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 账号的token |
| Content-Type | 是    | String | MIME类型   |
   
表3请求Body参数 
| 参数  | 是否必选 | 参数类型                                                        | 描述               |
|:---|:---|:---|:---|
| tag | 是    | [ResourceTag] object | resource_tag字段说明 |
   
 表4ResourceTag 
| 参数    | 是否必选 | 参数类型   | 描述                                                                                                                                                                                         |
|:---|:---|:---|:---|
| key   | 是    | String | 标签的键。 最大长度128个字符。 key不能为空，不能包含非打印字符ASCII(0-31)，"=","\*","\<","\>","\\",",","\|","/"。只能包含大写字母、小写字母、数字，特殊字符"-"和"_"。    |
| value | 是    | String | 标签的值。 每个值最大长度255个字符，可以为空字符串。 不能包含非打印字符ASCII(0-31)，"=","\*","\<","\>","\\",",","\|","/"。只能包含大写字母、小写字母、数字，特殊字符"-"和"_"。 |
   
#### 响应参数
**状态码：204**
创建共享标签请求下发成功
无
#### 请求示例
创建一个共享标签，标签的键为"key1"，标签的值为"value1"。
```
{
  "tag" : {
    "key" : "key1",
    "value" : "value1"
  }
}
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 204 | 创建共享标签请求下发成功 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-sfsturbo/ErrorCode.html)。