すべてのプロダクト
Search
ドキュメントセンター

Delete a scaling group

最終更新日: Mar 18, 2020

説明

この操作では、指定したスケーリンググループを削除します。

(1) ForceDelete では、スケーリンググループに ECS インスタンスがある場合、またはスケーリングアクティビティが進行中の場合に、スケーリンググループを強制的に削除し、ECS インスタンスを削除してリリースするかどうかを指定します。

(2) ForceDelete が false に設定されている場合、スケーリンググループを削除できるのは、次の 2 つの条件が満たされた場合に限られます。

  • 条件 1: スケーリンググループに進行中のスケーリングアクティビティがない。
  • 条件 2: スケーリンググループに現在含まれている ECS インスタンスの数 (合計容量) が 0 である。
  • これらの 2 つの条件が満たされた場合、スケーリンググループが無効になり、削除されます。

(3) ForceDelete が true に設定されている場合

  • スケーリンググループが無効になり、新しいスケーリングアクティビティリクエストが拒否されます。既存のスケーリングアクティビティが完了すると、最初にスケーリンググループからすべての ECS インスタンスが削除され、次にそのスケーリンググループが削除されます (手動でアタッチした ECS インスタンスはスケーリンググループから削除され、Auto Scaling サービスによって自動的に作成された ECS インスタンスは削除されます)。

(4) スケーリンググループを削除すると、スケーリング設定、ルール、アクティビティ、およびリクエストも削除されます。

(5) スケジュール済みタスク、CloudMonitor アラームタスク、Server Load Balancer インスタンス、および RDS インスタンスは削除されません。

リクエストパラメーター

名前 必須かどうか 説明
Action String はい 操作インターフェイス名、必須パラメーター。値: DeleteScalingGroup。
ScalingGroupId String はい スケーリンググループ ID。
ForceDelete Bool いいえ スケーリンググループに ECS インスタンスがある場合、またはスケーリングアクティビティが進行中の場合に、スケーリンググループを強制的に削除し、ECS インスタンスを削除してリリースするかどうかを指定します。デフォルト値は false で、スケーリンググループは強制的に削除されません。

リターンパラメーター

パブリックパラメーター

エラーコード

エラー エラーコード 説明 HTTP ステータスコード
指定したスケーリンググループがこのアカウントに存在しません。 InvalidScalingGroupId.NotFound 指定したスケーリンググループが存在しません。 404
Auto Scaling サービスに対して、Open API は完全には許可されていません。 Forbidden.Unauthorized 指定したアクションに必要な許可が付与されていません。 403
指定したスケーリンググループに ECS インスタンスが存在しています。 InstanceInUse スケーリング設定およびスケーリンググループは、インスタンスが関連付けられている間は削除できません。 400

リクエストの例

  1. http://ess.aliyuncs.com/?Action=DeleteScalingGroup
  2. &ScalingGroupId=dmIDKNcyWfzncX9MWX1bwFV
  3. &<Public Request Parameters>

戻り値の例

XML の例

  1. <DeleteScalingGroupResponse>
  2. <RequestId>6469DCD0-13AC-487E-85A0-CE4922908FDE</RequestId>
  3. </DeleteScalingGroupResponse>

JSON 形式

  1. {
  2. "RequestId": "6469DCD0-13AC-487E-85A0-CE4922908FDE"
  3. }