# 批量添加资源标签 - TagResources
#### 功能介绍
为指定资源（资源指通用文件系统）批量添加标签。一个资源上最多有20个标签。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-sfs/sfs_02_0079.html)。
#### URI
- POST /v3/sfs/tms/{project_id}/file-systems/{resource_id}/tags/create
- 参数说明
  
  | 参数          | 是否必选 | 参数类型   | 描述                                                                                   |
  |:---|:---|:---|:---|
  | project_id  | 是    | String | 操作用户的项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-sfs/sfs_02_0090.html)。 |
  | resource_id | 是    | String | 资源ID，此处为通用文件系统名。                                                                     |
     
  
 
#### 请求参数
表1请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                               |
|:---|:---|:---|:---|
| Content-type | 是    | String | 发送的实体的MIME类型。 示例：application/json。 |
| X-Auth-Token | 否    | String | 用户Token。                                                         |
   
表2请求Body参数 
| 参数       | 是否必选 | 参数类型                                                    | 描述                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| tags     | 否    | List\<[resource_tag]\> | 标签列表。详情说明参见[表3]。 普通租户权限：该字段必选。 op_service权限：tags和sys_tags二选一。                                                                                                                                                                                                                                              |
| sys_tags | 否    | List\<[resource_tag]\> | 系统标签列表。op_service权限可以访问。 op_service权限：tags和sys_tags二选一。 目前调用此API时只包含一个resource_tag结构体： key固定为：_sys_enterprise_project_id value是UUID或0，value为0表示默认企业项目。 现在仅支持系统标签添加操作。 详情说明参见[表3]。 |
   
 表3resource_tag 
| 参数    | 是否必选 | 参数类型   | 描述                                                                                                                  |
|:---|:---|:---|:---|
| key   | 是    | String | 标签的键。最大长度为128个字符，不能为空，首尾不支持空格字符，以"_sys_"开头的键属于系统标签，不支持用户输入，可用UTF-8格式表示的任意语种的字母、数字和空格，以及"_"、"."、":"、"="、"+"、"-"、"@"。 |
| value | 是    | String | 标签的值。最大长度为255个字符，首尾不支持空格字符，值可以为空字符串，可用UTF-8格式表示的任意语种的字母、数字和空格，以及以下字符： "_"、"."、":"、"="、"+"、"-"、"@"。                  |
   
#### 响应参数
无
#### 请求示例
projectId为"c80a2157ba1d46c0825265947342077c"，通用文件系统名为"bucketName"，批量添加资源标签示例：
```
POST https://{endpoint}/v3/sfs/tms/c80a2157ba1d46c0825265947342077c/file-systems/bucketName/tags/create
```
请求体示例：
```
{
    "tags":[
        {
            "key":"key1",
            "value":"value1"
        },
        {
            "key":"key2",
            "value":"value2"
        }
    ]
}
```
#### 响应示例
无
#### 状态码
- 正常
| 状态码 | 描述          |
|:---|:---|
| 204 | 批量添加资源标签成功。 |
   
- 异常
| 状态码 | 描述       |
|:---|:---|
| 400 | 标签等参数非法。 |
| 401 | 认证失败。    |
| 403 | 鉴权失败。    |
| 404 | 资源未找到。   |
| 500 | 系统异常。    |