
# 创建微服务引擎标签 - CreateMicroserviceEngineTag
#### 功能介绍
创建微服务引擎标签。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cse/cse_06_0081.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                    | 访问级别  | 资源类型（\*为必须） | 条件键                                                                                                                                                                                                                                                                                                                                                              | 别名                | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | cse:engine:tagResource | write | engine      | - *[g:ResourceTag/\<tag-key\>](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)*   - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)   | cse:engine:modify | -      |
     
  
 
#### URI
POST /v2/{project_id}/{resource_type}/{resource_id}/tags/create
表1路径参数 
| 参数            | 是否必选 | 参数类型   | 描述                     |
|:---|:---|:---|:---|
| project_id    | 是    | String | 租户子项目的唯一标识。字符长度为1\~64。 |
| resource_type | 是    | String | 资源类型。                  |
| resource_id   | 是    | String | 资源id。                  |
   
#### 请求参数
表2请求Header参数 
| 参数                      | 是否必选 | 参数类型   | 描述                                                                                               |
|:---|:---|:---|:---|
| X-Auth-Token            | 是    | String | 用户Token。                                                                                         |
| X-Enterprise-Project-ID | 否    | String | 如果不带则默认企业项目为"default"，ID为"0"。 默认取值： 0 |
| Content-Type            | 是    | String | 该字段内容填为"application/json;charset=UTF-8" 。                                                        |
| Accept                  | 是    | String | 该字段内容填为"application/json"。                                                                       |
   
表3请求Body参数 
| 参数                       | 是否必选 | 参数类型                                                                                        | 描述            |
|:---|:---|:---|:---|
| tags                     | 是    | Array of [SimpleTag]     | 标签列表。         |
| action                   | 是    | String                                                                                      | 操作类型。         |
| sys_tags                 | 是    | Array of [SimpleTag]     | 系统标签。         |
| engineId                 | 是    | String                                                                                      | 引擎ID。         |
| resourceTags             | 否    | Array of [ResourceTag] | 资源标签列表。       |
| resourceTagsWithoutValue | 否    | Array of [ResourceTag] | 不带value的资源标签。 |
   
 表4SimpleTag 
| 参数    | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| key   | 是    | String | 标签的key。 |
| value | 是    | String | 标签的值。   |
   
 表5ResourceTag 
| 参数        | 是否必选 | 参数类型   | 描述          |
|:---|:---|:---|:---|
| id        | 否    | String | 资源标签的ID。    |
| key       | 否    | String | 资源标签的key。   |
| value     | 否    | String | 资源标签的value。 |
| engine_id | 否    | String | 引擎ID。       |
| type      | 否    | String | 类型。         |
| date_time | 否    | long   | 时间戳。        |
   
#### 响应参数
**状态码： 200**
**状态码： 400**
表6响应Body参数 
| 参数         | 参数类型   | 描述      |
|:---|:---|:---|
| error_code | String | 错误码。    |
| error_msg  | String | 错误信息。   |
| detail     | String | 详细定位信息。 |
   
**状态码： 500**
表7响应Body参数 
| 参数         | 参数类型   | 描述      |
|:---|:---|:---|
| error_code | String | 错误码。    |
| error_msg  | String | 错误信息。   |
| detail     | String | 详细定位信息。 |
   
#### 请求示例
```
POST https://{endpoint}/v2/{project_id}/{resource_type}/{resource_id}/tags/create
```
#### 响应示例
**状态码： 200**
success
```
{
   "tags": [
     {
      "key": "key",
      "value": "value"  
     }      
   ],
  "sys_tags": [
    {
      "key": "key",
      "value": "value"
    }        
   ],
   "action": "test",
   "resourceTags": 
    [
     {
      "id": "id",
      "key": "key",
      "value": "value",
      "engine_id": "engine_id",
      "type": "type",
      "date_time": 123456
     }      
    ],
}
```
#### 状态码
| 状态码 | 描述       |
|:---|:---|
| 200 | success  |
| 400 | 错误的请求。   |
| 500 | 服务器内部错误。 |
   
#### 错误码
请参见[CSE错误码](https://support.huaweicloud.com/api-cse/cse_06_0109.html)。
