調用DeleteSecurityGroup接口,并指定參數RegionId、SecurityGroupId以刪除一個安全組。安全組刪除后,組內所有安全組規則將被刪除。
接口說明
調用該接口時,您需要注意:
- 刪除安全組之前,請確保安全組內不存在實例,并且沒有其他安全組與該安全組有授權行為( DescribeSecurityGroupReferences ),否則 DeleteSecurityGroup 請求失敗。
- 在您使用該接口刪除安全組時返回錯誤碼 InvalidOperation.DeletionProtection,或使用控制臺刪除安全組看到類似刪除保護的提示時,說明該安全組開啟了刪除保護功能。在您創建 ACK 集群時,關聯的安全組會開啟刪除保護功能,來防止誤刪除。刪除保護功能無法手動關閉,只有在刪除了關聯的 ACK 集群后,才能夠自動關閉。更多信息,請參見關閉安全組刪除保護。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 地域 ID。您可以調用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
SecurityGroupId | string | 是 | 安全組 ID。您可以調用 DescribeSecurityGroups 查看安全組 ID。 | sg-bp1fg655nh68xyz9**** |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | MissingParameter.RegionId | The parameter "RegionId" should not be null. | - |
401 | InvalidOperation.SecurityGroupNotAuthorized | The specified security group is not authorized to operate. | 沒有權限操作當前安全組 |
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 | 云產品托管的安全組不支持修改操作。 |
404 | InvalidSecurityGroup.NotFound | The specified security group is not found. | 找不到指定的安全組 |
500 | InternalError | The request processing has failed due to some unknown error. | 內部錯誤,請重試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-01-03 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |