2.7. TerminateInstances

サーバー(インスタンス)を削除します。

2.7.1. リクエストパラメータ

InstanceId.N  サーバー(インスタンス)のIDです。Nは指定する数だけ1から連番になります。複数指定する場合は InstanceId.1=a******1&InstanceId.2=b******2のように指定します。

  • 必須パラメータ: Yes

2.7.2. サンプルリクエスト

curl -X GET \
-H 'X-KAGOYA-Auth: 768*******************50f' \
http://kcs-api.kagoya.com/ec2?Action=TerminateInstances \
&InstanceId.1=a*****1

※注意 削除するサーバーは電源OFFの状態である必要があります。電源ON状態のサーバーを指定するとエラーとなります。
複数のサーバーIDを指定した場合、先に指定したものが電源OFFのサーバーである場合は削除されますが、 後に電源ON状態のサーバーを指定した場合は電源ON状態のサーバーは削除されず、最終的にエラーレスポンスになります。

2.7.3. サンプルレスポンス

エラーの場合は共通エラーレスポンスに従いエラー内容がレスポンスされます。 State名の意味は以下の通り

  • stopped : 停止中

  • running : 稼働中

  • pending : 削除済み

<?xml version="1.0" encoding="utf-8"?>
<TerminateInstancesResponse>
    <instancesSet>
        <item>
            <instanceId>c9d2db0</instanceId>
            <currentState>
                <code>0</code>
                <name>pending</name>
            </currentState>
            <previousState>
                <code>16</code>
                <name>running</name>
            </previousState>
        </item>
    </instancesSet>
</TerminateInstancesResponse>