この操作では、ECS インスタンスを再起動します。
説明
- 再起動できるのは、実行中 (
Running
) 状態の ECS インスタンスのみです。 - ECS インスタンスを再起動すると、 起動中 (
Starting
) 状態になります。 - 強制再起動 (
ForceStop
) がサポートされています。 インスタンスのデータがディスクにまだ書き込まれていない場合、強制再起動はデータ損失の原因になる場合があります。 - Security Control が有効で、
OperationLocks
タグが付いた"LockReason": "security"
ECS インスタンスは再起動できません。
デバッグ
API Explorer を使用してデバッグを実行することができます。 API Explorer で各種操作を実行して API の使用を簡素化することができます。 たとえば、API の取得、API の呼び出し、SDK のサンプルコードの動的な生成ができます。
リクエストパラメーター
名前 | データ型 | 必須 / 任意 | 例 | 説明 |
---|---|---|---|---|
InstanceId | String | 必須 | i-instance1 |
インスタンスの ID です。 |
Action | String | 任意 | RebootInstance |
実行する操作です。 値を RebootInstance に設定します。 |
ForceStop | Boolean | 任意 | false |
再起動する前にインスタンスを強制的に停止するかどうかを示します。 デフォルト値: false 。 有効値:
|
OwnerAccount | String | 任意 | ECSforCloud@Alibaba.com |
RAM ユーザーのログインネームです。 |
レスポンスパラメーター
名前 | データ型 | 例 | 説明 |
---|---|---|---|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
リクエスト ID です。 API 操作の結果にかかわらず、各 API リクエストに対してシステムから固有の RequestId が返されます。 |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=RebootInstance
&InstanceId=i-instance1
&ForceStop=false
&<Common request parameters>
通常のレスポンス例
XML
形式
<RebootInstanceResponse>
<RequestId>F2E2C40D-AB09-45A1-B5C5-EB9F5C4E4E4A</RequestId>
</RebootInstanceResponse>
JSON
形式
{
"RequestId":"F2E2C40D-AB09-45A1-B5C5-EB9F5C4E4E4A"
}
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
403 | IncorrectInstanceStatus | The current status of the resource does not support this operation. | リソースの現行ステータスで該当の操作がサポートされていない場合に返されるエラーメッセージです。 |
403 | DiskError | IncorrectDiskStatus。 | 指定された DiskCategory が無効な場合に返されるエラーメッセージです。 |
403 | InstanceExpiredOrInArrears | The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). | サブスクリプションインスタンスの有効期限が切れている場合に返されるエラーメッセージです。 先にインスタンスを更新してください。 |
403 | IncorrectInstanceStatus | %s | インスタンスの現行ステータスで該当の操作がサポートされていない場合に返されるエラーメッセージです。 |