將一台執行個體移出指定的安全性群組。
描述
調用該介面時,您需要注意:
-
移出安全性群組之前,執行個體必須處於 已停止(
Stopped
)或者 運行中(Running
)狀態。 -
一台執行個體必須至少加入一個安全性群組,當該執行個體只加入了一個安全性群組時,則
LeaveSecurityGroup
請求會失敗。
請求參數
名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
Action | String | 是 | 系統規定參數。取值:LeaveSecurityGroup |
InstanceId | String | 是 | 執行個體 ID。 |
SecurityGroupId | String | 是 | 安全性群組 ID。 |
返回參數
全是公共返回參數。參閱 公共參數。
樣本
請求樣本
https://ecs.aliyuncs.com/?Action=LeaveSecurityGroup
&InstanceId=i-instance1
&SecurityGroupId=F876FF7BA984
&<公共請求參數>
返回樣本
XML 格式
<LeaveSecurityGroupResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</LeaveSecurityGroupResponse>
JSON 格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
錯誤碼
以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心。
錯誤碼 | 錯誤資訊 | HTTP 狀態碼 | 說明 |
---|---|---|---|
IncorrectInstanceStatus | The current status of the resource does not support this operation. | 403 | 移出安全性群組之前,執行個體必須處於 已停止(Stopped )或者 運行中(Running )狀態。 |
InstanceLastSecurityGroup | The specified security group is the last security group for the instance. | 403 | 該安全性群組是該執行個體唯一的安全性群組,一台執行個體必須至少加入一個安全性群組。 |
InstanceLockedForSecurity | The specified operation is denied as your instance is locked for security reasons. | 403 | 被 安全控制 的執行個體的 OperationLocks 中標記了 "LockReason" : "security" 時,無法移出安全性群組。 |
InstanceNotInSecurityGroup | The instance not in the group. | 403 | 指定執行個體不在指定安全性群組中。 |
InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 404 | 指定的 InstanceId 不存在。 |
InvalidSecurityGroupId.NotFound | The specified SecurityGroupId does not exist. | 404 | 指定的 SecurityGroupId 不存在。 |