调用DeleteSecurityGroup删除一个安全组。
接口说明
调用该接口时,您需要注意:
- 删除安全组之前,请确保安全组内不存在实例,并且没有其他安全组与该安全组有授权行为(DescribeSecurityGroupReferences),否则DeleteSecurityGroup请求失败。
- 在您使用该接口删除安全组时返回错误码InvalidOperation.DeletionProtection,或使用控制台删除安全组看到类似删除保护的提示时,说明该安全组开启了删除保护功能。在您创建ACK集群时,关联的安全组会开启删除保护功能,来防止误删除。删除保护功能无法手动关闭,只有在删除了关联的ACK集群后,才能够自动关闭。更多信息,请参见关闭安全组删除保护。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | DeleteSecurityGroup | 系统规定参数。取值:DeleteSecurityGroup。 |
RegionId | String | 是 | cn-hangzhou | 地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。 |
SecurityGroupId | String | 是 | sg-bp1fg655nh68xyz9**** | 安全组ID。您可以调用DescribeSecurityGroups查看安全组ID。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | 请求ID。 |
示例
请求示例
http(s)://ecs.aliyuncs.com/?Action=DeleteSecurityGroup
&RegionId=cn-hangzhou
&SecurityGroupId=sg-bp1fg655nh68xyz9****
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DeleteSecurityGroupResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</DeleteSecurityGroupResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
错误码
HttpCode |
错误码 |
错误信息 |
描述 |
400 | InvalidOperation.DeletionProtection | The operation is not allowed due to "SecurityGroup" is protected by ACK deletion protection. | 该操作无效,请先关闭该安全组的删除保护。 |
403 | DependencyViolation | There is still instance(s) in the specified security group. | 安全组中还有未释放的实例,请您先释放实例再进行该操作。 |
403 | DependencyViolation | The specified security group has been authorized in another one. | 指定的安全组被另一个安全组的规则引用,不允许删除。 |
403 | InvalidOperation.ResourceManagedByCloudProduct | %s | 云产品托管的安全组不支持修改操作。 |
500 | InternalError | The request processing has failed due to some unknown error. | 内部错误,请重试。 |
访问错误中心查看更多错误码。