ECSインスタンスのシステムディスクまたはオペレーティングシステムを交換します。

ECSインスタンスのシステムディスクまたはオペレーティングシステムを交換します。このインターフェイスを呼び出すときは、次の点に注意する必要があります。

  • ECSインスタンスのシステムディスクのカテゴリを変更することはできません。
  • システムディスクを交換すると、ECSインスタンスのシステムディスクのディスクIDが交換されます。
  • システムディスクの請求方法は変更されません。アクションが完了すると、元のシステムディスクが解放されます。
  • ECSインスタンスのステータスは「停止」でなければなりません。
  • インスタンスは停止状態でなければなりません。VPC接続済みインスタンスに停止したインスタンスの料金はかかりません（VPC インスタンス）機能が有効になっている場合は、再起動を正常に行うためにインスタンスを停止するときにこの機能を無効にすることをおすすめします。詳細は、 StopInstance を参照してください。
  • ECSインスタンスでは未払いの注文が無いこと。
  • 指定されたインスタンスがセキュリティ上の理由でインスタンスがロックされる場合の API の挙動の場合、インスタンスの OperationLocks は "LockReason" ： "security"にすることはできません。
  • パラメータSystemDisk.Sizeを指定することにより、システムディスクのサイズを指定することができます。 SystemDisk.Sizeはmax {20、[以前のシステムディスクのサイズ]}以上でなければなりません。 SystemDisk.Sizeがmax {20、[元のシステムディスクのボリューム]}を超えた部分に対しては追加料金が発生します。

リクエストパラメーター

Action String Yes このインタフェースの名前、値: ReplaceSystemDisk
InstanceId String Yes 指定されたインスタンス ID
ImageId String Yes システムのリセット時に使用されるイメージの ID。
Password String No ECSインスタンスのパスワード。
  • [8、30]文字で、3種類の文字、大文字または小文字、数字、特殊記号を含める必要があります。
  • 以下の特別な文字をサポートする: ( ) ' ~ ! @ # $ % ^ & * − + = | { } [ ] : ; ‘ < > , . ? /
  • Passwordパラメータを指定する場合は、HTTPSを使用してAPIを呼び出して、パスワード違反を避けます。
PasswordInherit Boolean No 選択したイメージで事前設定されたパスワードを使用するかどうか選べます。PasswordInheritが指定されるとき、Passwordはnullでなければなりません。安全なアクセスのために、選択したイメージにパスワードが設定されていることを確認してください。
KeyPairName String No Key pair name.
  • Windowsインスタンスの場合、このパラメータは無視し、デフォルト値はnullです。 KeyPairNameパラメータに値が設定されている場合、Passwordパラメータは依然として有効です。
  • Linuxインスタンスの場合、 KeyPairNameパラメータに値が設定されていると、usernameのパスワードは無効になります。
SystemDisk.Size integer No 新しいシステムディスクのサイズ (GB 単位) 有効範囲：[最大 {20、[指定された画像ファイルのサイズ]}、500] デフォルト値：最大 {40、[指定された画像ファイルのサイズ]}
ClientToken String No リクエストのべき等性を保証するために使用されます。値はクライアントによって生成されます。すべてのリクエストで一意でなければならず、最大 64 文字の ASCII 文字を含みます。詳細については、付録「べき等性を確保する方法」を参照してください。
SecurityEnhancementStrategy String No セキュリティ強化機能を有効にして、ネットワークセキュリティソフトウェアを無料でインストールするかどうかを選ぶことができます。オプションの値：
  • アクティブ： セキュリティ強化機能を有効にし、ネットワークセキュリティソフトウェアを無料でインストールします。 Alibaba Cloudの公開画像にのみ適用されます。
  • 非アクティブ: セキュリティ強化機能を無効にし、ネットワークセキュリティソフトウェアのインストールを無効にします。 あらゆる種類の画像に適用できます。

リターンパラメーター

名前 型 説明
DiskId String 新しいシステムディスクのディスク ID

例

リクエストの例

https://ecs.aliyuncs.com/?Action=ReplaceSystemDisk
&InstanceId=i-23jggx34b
&ImageId=m-myimage11
&<Public Request Parameters>

戻り値の例

XML 形式

<ReplaceSystemDiskResponse>
    <DiskId>d-23jbf2v5m</DiskId>
    <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
</ReplaceSystemDiskResponse>

JSON 形式

{
  "DiskId": "d-23jbf2v5m",
  "RequestId": "F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
}

Error codes

InvalidParameter.Conflict 指定されたイメージは、指定されたインスタンスタイプをサポートしていません。 400 指定されたイメージは、指定されたインスタンス・タイプでは実行できません。
InvalidPassword.Malformed 指定されたパラメータ “Password” は無効です。 400 指定されたパスワードは無効です。
InvalidPasswordParam.Mismatch passwdInherit が true の場合、入力パスワードは null にする必要があります。 400 PasswordInheritが指定されるとき、Passwordは null でなければなりません。
InvalidSystemDiskSize 指定されたパラメータ SystemDisk.Size が無効です。 400 指定されたSystemDisk.Sizeが無効です。
InvalidSystemDiskSize.ImageNotSupportResize 指定されたイメージはサイズ変更をサポートしていません。 400 指定した ImageId に対して SystemDisk.Size を指定することはできません。
InvalidSystemDiskSize.ValueNotSupported 指定されたパラメータSystemDisk.Sizeが無効です。 400 指定されたSystemDisk.Sizeが無効です。
OperationDenied 指定したイメージにはデータディスクのスナップショットが含まれていますが、この操作はサポートされていません。 400 指定したイメージがデータディスクのデータを含むスナップショットを使用して作成された場合、指定されたインスタンスのシステムディスクを変更することはできません。
ChargeTypeViolation この操作は、インスタンスの課金タイプのために操作が許可されていません。 403 請求方法により、指定されたインスタンスのシステムディスクを変更することはできません。
DiskCreatingSnapshot 指定されたディスクのスナップショットがまだ完了していないため、操作が拒否されました。 403 指定したディスクのスナップショットが作成されています。後でやり直してください。
ImageNotSubscribed 指定されたイメージはサブスクライブされていません。 403 アクションの前に指定されたイメージを購読する必要があります。
ImageNotSupportInstanceType 指定されたイメージはInstanceTypeインスタンスをサポートしていません。 403 指定したイメージは、インスタンスの指定されたカテゴリで実行できません。
ImageRemovedInMarket 指定された市場イメージが利用できないか、指定されたユーザー定義イメージに商品コードが含まれているのはマーケットプレイスから購読されたイメージに基づいているからであり、 存在する同じ商品コードのイメージは消去されています。 403 指定されたImageIdはクラウド市場では使用できなくなりました。
IncorrectInstanceStatus リソースの現在のステータスはこの操作をサポートしていません。 403 ECSインスタンスのステータスは「停止」する必要があります。
INST_HAS_UNPAID_ORDER インスタンスに未払いの注文があります。 403 指定されたインスタンスに未払いの注文が存在します。
InstanceExpiredOrInArrears 前払いインスタンスが期限切れ（前払いモード）または延滞（後払いモード）になると、指定された操作は拒否されます。 403 指定したインスタンスに期限が過ぎています。
InstanceLockedForSecurity インスタンスはセキュリティのためにロックされています。 403 セキュリティ上の理由から、指定されたインスタンスはセキュリティ上の理由でインスタンスがロックされる場合の API の挙動になります。
IoOptimized.NotSupported 指定されたイメージはIoOptimizedインスタンスをサポートしていません。 403 指定されたImageIdは、I/Oに最適化されたインスタンスで実行する必要があります。
QuotaExceed.BuyImage 指定されたイメージはイメージマーケットからのもので、購入していないか、クォータが超過しています。 403 アクションの前に、指定したImageIdを購入する必要があります。購入した利用可能な画像は最大数に達しました。
InvalidImageId.NotFound 指定されたImageIdは存在しません。 404 指定されたImageIdは存在しません。
InvalidInstanceId.NotFound The specified InstanceId does not exist.指定されたInstanceIdは存在しません。 404 The specified InstanceId does not exist.指定されたInstanceIdは存在しません。
InvalidSystemDiskSize.LessThanImageSize 指定されたパラメータSystemDisk.Sizeがイメージサイズより小さい。 404 指定されたSystemDisk.Sizeは、以前のシステムディスクのサイズより小さくすることはできません。
InvalidSystemDiskSize.LessThanMinSize 指定されたパラメータSystemDisk.Sizeが最小サイズより小さい。 404 指定されたSystemDisk.Sizeは40 GBより小さくすることはできません。
InvalidSystemDiskSize.MoreThanMaxSize 指定されたSystemDisk.Sizeパラメーターが最大サイズを超えています 404 指定されたSystemDisk.Sizeは500 GBを超えることはできません。
NoSuchResource 指定されたリソースが見つかりません。 404 指定されたリソースは存在しません。
OperationDenied 内部エラー。 500 内部エラーです。後でもう一度お試しください。