
# 创建或删除标签 - Create/DeleteScalingTagInfo
#### 功能介绍
创建或删除指定资源的标签。
每个伸缩组最多添加10个标签。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/AS/doc?api=CreateScalingTagInfo)中调试该接口。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-as/as_07_0200.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项               | 访问级别    | 资源类型（\*为必须） | 条件键                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 别名          | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | as::tagResource   | tagging | -           | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2)  - [g:ResourceTag/\<tag-key\>](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2)  - [g:TagKeys](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)                                                                 | as:tags:set | -      |
  | as::untagResource | tagging | -           | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2)  - [g:ResourceTag/\<tag-key\>](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2)    - [g:TagKeys](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html)   | as:tags:set | -      |
     
  
 
#### URI
POST /autoscaling-api/v1/{project_id}/{resource_type}/{resource_id}/tags/action
表1参数说明 
| 参数            | 是否必选 | 参数类型   | 描述                                                                  |
|:---|:---|:---|:---|
| project_id    | 是    | String | 项目ID                                                                |
| resource_type | 是    | String | 资源类型，枚举类： scaling_group_tag：资源类型为伸缩组。 |
| resource_id   | 是    | String | 资源ID                                                                |
   
#### 请求参数
表2请求参数 
| 参数     | 是否必选 | 参数类型                                                             | 描述                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| tags   | 是    | Array of [ResourceTag] objects | 标签列表。详情请见[表 ResourceTag字段数据结构说明]。 action为delete时，tags结构体不能缺失，key不能为空，或者空字符串。                                                                                                           |
| action | 是    | String                                                           | 操作标识（区分大小写）： - delete：删除。  - create：创建。若已经存在相同的key值则会覆盖对应的value值。   |
   
 表3ResourceTag字段数据结构说明 
| 参数    | 是否必选 | 参数类型   | 描述                                                                                                                |
|:---|:---|:---|:---|
| key   | 是    | String | 资源标签键。同一资源的key值不能重复。 最大长度36个字符。字符集：A-Z，a-z，0-9，'-'，'_'，UNICODE字符（\\u4E00-\\u9FFF）。   |
| value | 否    | String | 资源标签值。 每个值最大长度43个字符，可以为空字符串。字符集：A-Z，a-z，0-9，'.'，'-'，'_'，UNICODE字符（\\u4E00-\\u9FFF）。 |
   
#### 请求示例
创建资源标签，在ID为e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸缩组下，一组资源键值对为key=ENV15，value=ENV15，另一组资源键值对key=ENV151，value=ENV151。
```
POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_tag/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/tags/action
{ 
  "tags": [
    { 
        "key": "ENV15", 
        "value": "ENV15" 
    }, 
    { 
        "key": "ENV151", 
        "value": "ENV151" 
    }
    ], 
  "action": "create" 
}
```
#### 响应参数
无
#### 响应示例
无
#### 返回值
- 正常 204
  
- 异常
  
  | 返回值                               | 说明                           |
  |:---|:---|
  | 400 Bad Request                   | 服务器未能处理请求。                   |
  | 401 Unauthorized                  | 被请求的页面需要用户名和密码。              |
  | 403 Forbidden                     | 对被请求的页面访问禁止。                 |
  | 404 Not Found                     | 服务器无法找到被请求的页面。               |
  | 405 Method Not Allowed            | 请求中指定的方法不被允许。                |
  | 406 Not Acceptable                | 服务器生成的响应无法被客户端所接受。           |
  | 407 Proxy Authentication Required | 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 |
  | 408 Request Timeout               | 请求超出了服务器的等待时间。               |
  | 409 Conflict                      | 由于冲突，请求无法被完成。                |
  | 500 Internal Server Error         | 请求未完成，服务异常。                  |
  | 501 Not Implemented               | 请求未完成，服务器不支持所请求的功能。          |
  | 502 Bad Gateway                   | 请求未完成，服务器从上游服务器收到一个无效的响应。    |
  | 503 Service Unavailable           | 请求未完成，系统暂时异常。                |
  | 504 Gateway Timeout               | 网关超时。                        |
     
  
 
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-as/as_07_0102.html)。
