この API を呼び出すと、ディスクを再初期化して、作成時の状態に復元できます。

説明

この API を呼び出すときは、次の点に注意してください。

  • 操作は、ディスクが使用中の状態で、ディスクに接続されているインスタンスが停止状態の場合にのみ実行できます。
  • 作成後にインスタンスが起動されていない場合、インスタンスに接続されているディスクは再初期化できません。
  • システムディスクは作成時の初期状態に復元されます。 ディスクの作成に使用したソースイメージを削除すると、ディスクを初期化できません。
  • ユーザーが作成したデータディスクは、空のデータディスクの状態に初期化されます。
  • スナップショットから作成されたデータディスクは、スナップショットの状態に初期化されます。 ディスクの作成に使用したソーススナップショットを削除すると、ディスクを初期化できず、エラーが返されます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 OpenAPI Explorer を使用すると、API を簡単に設定できます。 OpenAPI Explorer は、各種 SDK に用意されている 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

システムディスクの再初期化後にセキュリティセンターを無料で使用するかどうかを指定します。 有効値：

  • Active：システムディスクが再初期化された後、セキュリティセンターは無料で使用されます。 この値は、パブリックイメージにのみ適用されます。
  • Deactive：システムディスクが再初期化された後、セキュリティセンターは無料で使用されません。 この値はすべてのイメージに適用されます。

デフォルト値 : 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」をご参照ください。