
# 创建安全组资源标签 - CreateSecurityGroupTag
#### 功能介绍
给指定安全组资源实例增加标签信息。
此接口为幂等接口：创建时，如果创建的标签已经存在（key相同），则覆盖。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/VPC/doc?api=CreateSecurityGroupTag&version=v2)中调试该接口，支持自动认证鉴权。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-vpc/vpc_permission_0000.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                           | 访问级别    | 资源类型（\*为必须）      | 条件键                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | 别名                           | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | vpc:securityGroups:createTags | Tagging | securityGroup \* | - g:EnterpriseProjectId   - g:ResourceTag/\<tag-key\>   - vpc:SecurityGroupId    | vpc:securityGroupTags:create | -      |
  | vpc:securityGroups:createTags | Tagging | -                | - g:RequestTag/\<tag-key\>   - g:TagKeys                                                                                                                                                                                                                                                                                                            | vpc:securityGroupTags:create | -      |
     
  
 
#### URI
POST /v2.0/{project_id}/security-groups/{security_group_id}/tags
表1路径参数 
| 参数                | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| project_id        | 是    | String | 项目ID    |
| security_group_id | 是    | String | 安全组资源ID |
   
#### 请求参数
表2请求Body参数 
| 参数  | 是否必选 | 参数类型                                                                                            | 描述           |
|:---|:---|:---|:---|
| tag | 是    | [ResourceTag] object | 创建安全组资源标签请求体 |
   
 表3ResourceTag 
| 参数    | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| key   | 是    | String | - 功能说明：标签键   - 约束： - 不能为空。   - 长度不能超过128字符。   - 同一资源的key值不能重复。   - 由英文字母、数字、下划线、中划线、中文字符组成。      |
| value | 是    | String | - 功能说明：标签值   - 约束： - 长度不能超过255字符。   - 由英文字母、数字、下划线、点、中划线、中文字符组成。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
   
#### 响应参数
**状态码：204**
请求正常返回，更多状态码请参见[状态码](https://support.huaweicloud.com/api-vpc/vpc_api_0002.html)。
无
#### 请求示例
创建安全组资源标签
```
POST https://{Endpoint}/v2.0/{project_id}/security-groups/{security_group_id}/tags
{
  "tag" : {
    "key" : "key1",
    "value" : "value1"
  }
}
```
#### 响应示例
无
#### 状态码
| 状态码 | 描述                                                                               |
|:---|:---|
| 204 | 请求正常返回，更多状态码请参见[状态码](https://support.huaweicloud.com/api-vpc/vpc_api_0002.html)。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-vpc/vpc_api_0003.html)。
