edit-icon download-icon

LeaveSecurityGroup

最終更新日: Aug 01, 2018

説明

指定したセキュリティグループからインスタンスを削除します。 このインターフェイスを呼び出すときは、次の点を考慮してください。

  • セキュリティグループからインスタンスを削除するには、インスタンスを「停止済み」または「実行中」の状態にする必要があります。
  • 各インスタンスは少なくとも 1 つのセキュリティグループに属している必要があります。1 つのセキュリティグループに属しているインスタンスが 1 つのみで、このグループからこのインスタンスを削除しようとすると、リクエストは失敗します。

リクエストパラメーター

名前 必須かどうか 説明
Action String はい 値: LeaveSecurityGroup
InstanceId String はい 指定されたインスタンス ID
SecurityGroupId String はい セキュリティグループ ID

リターンパラメーター

すべてはパブリックリターンパラメーターです。詳細については、「パブリックリターンパラメーター」を参照してください。

リクエストの例

  1. https://ecs.aliyuncs.com/?Action=LeaveSecurityGroup
  2. &InstanceId=i-instance1
  3. &SecurityGroupId=F876FF7BA984
  4. &<Public Request Parameters>

レスポンスの例

XML 形式

  1. <LeaveSecurityGroupResponse>
  2. <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. </LeaveSecurityGroupResponse>

JSON 形式

  1. {
  2. "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. }

エラーコード

インタフェースに固有のエラーコードは次のとおりです。詳細については、API エラー・センターを参照してください。

エラーコード エラーメッセージ HTTP ステータスコード 意味
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 セキュリティグループから削除される前に、インスタンスが停止または実行中の状態でなければなりません。
InstanceLastSecurityGroup The specified security group is the last security group for the instance. 403 各インスタンスには、少なくとも1つのセキュリティグループに属している必要があります。
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 存在しません。