ModifyReservedInstances を呼び出して、RI ( リザーブドインスタンス ) を変更することができます。

注意事項

RI を変更する前に、次の点に注意してください。

  • RI のリージョンは変更できません。 RI のゾーンのみを変更したり、リージョンレベルの RI をゾーンレベルの RI に変更したり、ゾーンレベルの RI をリージョンレベルの RI に変更したりすることができます。
  • RI のインスタンスタイプファミリーは変更できません。 RI のサイズのみを変更することができます。
  • 結合される RI がリージョンレベルの RI である場合、それらは同じリージョンになければなりません。 結合される RI がゾーンレベルの RI である場合、それらは同じゾーン内になければなりません。
  • 結合される RI は有効期限が同じでなければなりません。
  • RI が分割された後、または複数の RI が結合された後、最初の RI はすぐに失効します。

リクエストのパラメーター

名前 タイプ 必須 説明
Action String はい システムに必要なパラメーター。 値: ModifyReservedInstances
RegionId String Yes RI が属するリージョンの ID。 DescribeRegions を呼び出すと、最新のリージョンリストが表示されます。
ReservedInstanceId.N String はい RI の ID。 N は 1 ～ 20 の整数です。
Configuration.N Configuration はい 対象の RI の構成属性。
DryRun Boolean いいえ この要求だけを確認するかどうかを指定します。
  • true: 確認要求は送信されますが、インスタンスは作成されません。 必要なパラメーターが設定されているかどうかが確認され、さらに要求形式、サービス制限、および使用可能な ECS インスタンスも確認されます。 要求がチェックに合格しなかった場合、エラーが返されます。 要求がチェックに合格した場合、エラーコード DryRunOperation が返されます。
  • false: チェックリクエストが送信され、要求がチェックに合格した後にインスタンスが作成されます。

デフォルト値: "false"

次の表に構成データ型のパラメーターを示します。

名前 タイプ 必須 説明
ReservedInstanceName String いいえ RI の名前。 名前は 2 ～ 128 文字の長さの文字列であり、英字、数字、コロン (:)、アンダーバー (_)、およびハイフンを含めることができます。 先頭は文字でなければなりません。 http:// または https:// を先頭にしてはいけません。
InstanceType String はい RI のインスタンスタイプ。 詳細については、「インスタンスタイプファミリー」をご参照ください 。
Scope String はい RI の範囲。 オプションの値:
  • Region: リージョンレベル
  • Zone: ゾーンレベル

デフォルト値 : Region
ZoneId String いいえ RI が属するゾーンの ID。 "Scope" が "Zone" に設定されている場合、このパラメーターは必須です。 ゾーンリストについての情報は、「 DescribeZones 」をご参照ください。
InstanceAmount Integer Yes RI に割り当てられたインスタンスの数 (RI は、インスタンスが 1 つ以上割り当てられているクーポンです)。

レスポンスのパラメーター

名前 タイプ 説明
RequestId String リクエスト ID
ReservedInstanceIdSets List RI ID のリスト。 リスト内の ID は、RI にアクセスするための一意の ID です。
OrderId Long オーダー ID