:StopInstance

説明

• 実行中（Running）状態にあるインスタンスのみを停止できます。
• この API を呼び出すと、インスタンスは停止（Stopping）状態に入ります。 インスタンスが停止後、インスタンスは停止（Stopped）状態になります。
• インスタンスを強制停止できます。 ただし、インスタンスのデータがディスクに書き込まれていない場合、データ損失の原因になる場合があります。
• Security Control が有効になっており、OperationLocksタグが"LockReason" : "security"として付いている ECS インスタンスを停止することはできません。
• Local Disk Storage（Local \ _ storage）が構成され、I1 インスタンスタイプファミリであるインスタンスの場合、ConfirmStopを指定して、その値をTrueに設定する必要があります。 それ以外の場合は、エラーが返されます。
• I1 インスタンスタイプファミリの場合、ローカルディスクのデータは、インスタンスが停止した後にクリアされます。 データの可用性を保証するために、アプリケーション層にデータ冗長性を実装することを推奨します。
• 他のインスタンスタイプファミリのインスタンスの場合、ConfirmStopパラメーターは無視されます。
• StopCharging が選択されている場合、StoppedMode=KeepChargingを構成して KeepCharging にすることができます。 そうすればインスタンスの停止後も請求され、 インスタンスタイプとパブリック IP アドレスなどは、このインスタンス用に予約されます。

デバッグ

API Explorer でデバッグを実行できます。 API Explorer で各種操作を実行して API の使用を簡素化できます。 たとえば、API の取得、API の呼び出し、SDK のサンプルコードの動的な生成ができます。

リクエストパラメーター

レスポンスパラメーター

例

リクエスト例

https://ecs.aliyuncs.com/?Action=StopInstance
&InstanceId=i-instanceid1
&ConfirmStop=true
&ForceStop=false
&StoppedMode=keepcharging
&<Common request parameters>

通常のレスポンスの例

XML 形式

<StopInstanceResponse>
  <RequestId>1C488B66-B819-4D14-8711-C4EAAA13AC01</RequestId>
</StopInstanceResponse>

JSON 形式

{
	"RequestId":"1C488B66-B819-4D14-8711-C4EAAA13AC01"
}

エラーコード

エラーコードの表示