全部产品
Search
文档中心

云服务器 ECS:DeleteSecurityGroup

更新时间:Nov 16, 2023

调用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. 内部错误,请重试。

访问错误中心查看更多错误码。