この API を呼び出すと、ディスクを再初期化して、作成時の状態に復元できます。
説明
この API を呼び出すときは、次の点に注意してください。
- 操作は、ディスクが使用中の状態で、ディスクに接続されているインスタンスが停止状態の場合にのみ実行できます。
- 作成後にインスタンスが起動されていない場合、インスタンスに接続されているディスクは再初期化できません。
- システムディスクは作成時の初期状態に復元されます。 ディスクの作成に使用したソースイメージを削除すると、ディスクを初期化できません。
- ユーザーが作成したデータディスクは、空のデータディスクの状態に初期化されます。
- スナップショットから作成されたデータディスクは、スナップショットの状態に初期化されます。 ディスクの作成に使用したソーススナップショットを削除すると、ディスクを初期化できず、エラーが返されます。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
DiskId | String | 必須 | d-bp67acfmxazb4ph*** |
ディスクの ID。 |
Action | String | 必須 | ReInitDisk |
実行する API です。 値を ReInitDisk に設定します。 |
AutoStartInstance | Boolean | 任意 | true |
ディスクの再初期化後にインスタンスを自動的に起動するかどうかを指定します。 デフォルト値 : false 。 |
KeyPairName | String | 任意 | JoshuaCentOS |
キーペアの名前。 注 このパラメーターは、Linux インスタンスにのみ適用されます。 システムディスクを再初期化するときに、SSH キーペアをログイン認証情報としてインスタンスにバインドできます。
ただし、SSH キーペアをバインドした後、パスワードログイン方式は無効になります。
|
Password | String | 任意 | EcsV587! |
システムディスクを再初期化するときに、インスタンスのパスワードをリセットするかどうかを指定します。 パスワードの長さは 8~30 文字である必要があります。 大文字、小文字、数字、および次のような特殊文字の 3 種類以上の文字で構成されなければなりません。 特殊文字:
Windows インスタンスの場合、パスワードの先頭をスラッシュ (/) にすることはできません。 注
パスワード パラメーターが指定されている場合、パスワードのセキュリティを確保するために、 HTTPS を使用してリクエストを送信することを推奨します。
|
SecurityEnhancementStrategy | String | 任意 | Active |
システムディスクの再初期化後にセキュリティセンターを無料で使用するかどうかを指定します。 有効値:
デフォルト値 : Deactive。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
---|---|---|---|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
リクエストの ID 。 |
例
リクエスト例
https://ecs.aliyuncs.com/?Action=ReInitDisk
&DiskId=d-bp67acfmxazb4ph***
&KeyPairName=JoshuaCentOS
&AutoStartInstance=true
&SecurityEnhancementStrategy=Active
&<Common request parameters>
通常のレスポンス例
XML
形式
<ReInitDiskResponse>
<RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ReInitDiskResponse>
JSON
形式
{
"RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
404 | InvalidDiskId.NotFound | The specified disk does not exist. | 指定された DiskId パラメーターが存在しない場合に返されるエラーメッセージ。 ディスク ID が正しいか確認してください。 |
403 | IncorrectDiskStatus | The current disk status does not support this operation. | 現在のディスクのステータスでは該当の操作がサポートされていない場合に返されるエラーメッセージ。 ディスクが使用可能な状態にあり、料金の滞納がないことをご確認ください。 |
403 | IncorrectInstanceStatus | The current status of the resource does not support this operation. | 現在のリソースのステータスでは該当の操作がサポートされていない場合に返されるエラーメッセージ。 |
403 | InstanceLockedForSecurity | The instance is locked due to security. | セキュリティ上の理由によりリソースがロックされているため、該当の操作がサポートされていない場合に返されるエラーメッセージ。 |
403 | InvalidSnapshot.TooOld | The disk is created from a snapshotId made before 2013-07-15, it cannot be re-initiated the specified disk any more since the detached first time. | 指定されたスナップショットが 2013 年 7 月 15 日以前に作成されている場合に返されるエラーメッセージ。 |
403 | OperationDenied | The snapshot which is used to create the specified disk has been deleted. | 指定されたディスクの作成に使用されたスナップショットが存在しない場合に返されるエラーメッセージ。 |
403 | InstanceExpiredOrInArrears | The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). | サブスクリプションインスタンスの有効期限が切れた場合に返されるエラーメッセージ。 最初にインスタンスを更新してください。 |
403 | DiskCreatingSnapshot | The operation is denied due to a snapshot of the specified disk is not completed yet. | 指定されたディスクのスナップショットが作成中の場合に返されるエラーメッセージ。 |
403 | InvalidSourceSnapshot | The snapshot which is used to create the specified disk has been deleted. | 指定されたディスクの作成に使用されたスナップショットが削除された場合に返されるエラーメッセージ。 |
404 | InvalidImageId.NotFound | The specified ImageId does not exist. | 指定されたイメージが該当のアカウントに存在しない場合に返されるエラーメッセージ。 イメージ ID が正しいかどうかを確認してください。 |
403 | SharedImageDeleted | The specified image by others shared is deleted. | 指定された共有イメージが削除されている場合に返されるエラーメッセージ。 |
400 | InvalidPassword.Malformed | The specified parameter "Password" is not valid. | 指定された Password パラメーターが正しくない場合に返されるエラーメッセージ。 |
400 | DiskCategory.OperationNotSupported | The operation is not supported to the specified disk due to its disk category | 指定されたディスクカテゴリで、操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | InvalidKeyPairName.NotFound | The specified KeyPairName does not exist. | 指定された KeyPairName パラメーターが存在しない場合に返されるエラーメッセージ。 |
400 | DependencyViolation.IoOptimize | The specified parameter InstanceId is not valid. | 指定された InstanceId パラメーターが無効な場合に返されるエラーメッセージ。 |
400 | InvalidRegionId.MalFormed | The specified RegionId is not valid | 指定された RegionId パラメーターが無効な場合に返されるエラーメッセージ。 |
404 | InvalidDiskId.OperationNotSupported | The operation is not supported due to image not exist. | 指定された DiskId パラメーターが無効な場合に返されるエラーメッセージ。 |
エラーコードリストについては、「API Error Center」をご参照ください。