Elastic Compute Service:ModifyReservedInstances

この操作は非同期操作です。この操作を呼び出してリザーブドインスタンスを変更すると、変更プロセスが開始され、結果として生成される新しいリザーブドインスタンスの ID が返されます。元のリザーブドインスタンスは Updating ステータスになり、その後 Inactive ステータスになります。同時に、新しいリザーブドインスタンスが生成され、`Creating` ステータスになり、その後 `Active` ステータスになります。DescribeReservedInstances 操作を呼び出して、リザーブドインスタンスのステータスを照会できます。

• リザーブドインスタンスが Active ステータスの場合にのみ、その構成を変更できます。

• 変更の前後でリザーブドインスタンスの コンピューティング能力 が変更されないようにしてください。変更されると、操作は失敗します。

• リザーブドインスタンスの分割、マージ、範囲の変更を同時に行うことはできません。

詳細については、「リザーブドインスタンスの分割、マージ、変更」をご参照ください。

リクエスト例

• リザーブドインスタンスの分割リクエスト例：中国 (杭州) リージョンを範囲とし、ecs.g5.xlarge インスタンスタイプの従量課金インスタンス 2 台にマッチするリージョンリザーブドインスタンス 1 つを、中国 (杭州) リージョンを範囲とし、それぞれが ecs.g5.large インスタンスタイプの従量課金インスタンス 1 台にマッチするリージョンリザーブドインスタンス 2 つに分割します。

"RegionId":"cn-hangzhou", //リージョン ID。
"ReservedInstanceId":["ecsri-bp1hd03e9uv19e75****"], //分割するリザーブドインスタンスの ID。
"Configuration":[
  {
    "ReservedInstanceName":"testReservedInstanceName1", //新しいリザーブドインスタンスの名前。
    "InstanceType":"ecs.g5.large", //新しいリザーブドインスタンスがマッチするインスタンスタイプ。
    "Scope":"Region", //新しいリザーブドインスタンスの範囲レベル。元のリザーブドインスタンスの範囲レベルと同じである必要があります。
    "InstanceAmount":1 //各新しいリザーブドインスタンスがマッチする、指定されたインスタンスタイプの従量課金インスタンスの数。
  },
  {
    "ReservedInstanceName":"testReservedInstanceName2",
    "InstanceType":"ecs.g5.large",
    "Scope":"Region",
    "InstanceAmount":1
  }
]

• リザーブドインスタンスのマージリクエスト例：杭州ゾーン H を範囲とし、ecs.g5.xlarge インスタンスタイプの従量課金インスタンス 4 台にマッチするゾーンリザーブドインスタンス 2 つを、杭州ゾーン H を範囲とし、ecs.g5.4xlarge インスタンスタイプの従量課金インスタンス 2 台にマッチするゾーンリザーブドインスタンス 1 つにマージします。

"RegionId":"cn-hangzhou", //リージョン ID。
"ReservedInstanceId":["ecsri-bp1hd03e9uv16b75****",""ecsri-bp1hd03e9uv16b76****""], //マージするリザーブドインスタンスの ID。
"Configuration":[
  {
    "ReservedInstanceName":"testReservedInstanceName", //新しいリザーブドインスタンスの名前。
    "InstanceType":"ecs.g5.4xlarge", //新しいリザーブドインスタンスがマッチするインスタンスタイプ。
    "Scope":"Zone", //新しいリザーブドインスタンスの範囲レベル。元のリザーブドインスタンスの範囲レベルと同じである必要があります。
    "ZoneId":"cn-hangzhou-h", //
    "InstanceAmount":2 //新しいリザーブドインスタンスがマッチする、指定されたインスタンスタイプの従量課金インスタンスの数。
  }
]

• リザーブドインスタンスの範囲変更リクエスト例：杭州ゾーン H を範囲とし、ecs.g5.xlarge インスタンスタイプの従量課金インスタンス 6 台にマッチするゾーンリザーブドインスタンスを、中国 (杭州) リージョンを範囲とし、ecs.g5.2xlarge インスタンスタイプの従量課金インスタンス 3 台にマッチするリージョンリザーブドインスタンスに変更します。

"RegionId":"cn-hangzhou", //リージョン ID。
"ReservedInstanceId":["ecsri-bp1hd03e9uv16b77****"], //範囲を変更するリザーブドインスタンスの ID。
"Configuration":[
  {
    "ReservedInstanceName":"testReservedInstanceName", //新しいリザーブドインスタンスの名前。
    "InstanceType":"ecs.g5.2xlarge", //新しいリザーブドインスタンスがマッチするインスタンスタイプ。
    "Scope":"Region", //新しいリザーブドインスタンスの範囲レベル。
    "InstanceAmount":3 //新しいリザーブドインスタンスがマッチする、指定されたインスタンスタイプの従量課金インスタンスの数。
  }
]