従量課金インスタンスご購入後、 料金割引の恩恵を受けることができるように、 PurchaseReservedInstancesOffering を使用して、RI (リザーブドインスタンス) を購入することができます。

説明

RI を購入する前に DescribeAvailableResource を呼び出し、利用可能なインスタンスのリソースを照会します。

RI を購入する前に、適用される請求方法の詳細を確認するために、「リザーブドインスタンスの請求方法」に目を通すことを推奨します。

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

名前 タイプ 必須 説明
Action String はい システムに必要なパラメーター。 値: PurchaseReservedInstancesOffering
RegionId String はい RI が属するリージョン ID。 DescribeRegions を呼び出すと、最新のリージョンリストを表示できます。
Scope String はい RI の範囲。 オプションの値:
  • Region: リージョンレベル
  • Zone: ゾーンレベル

デフォルト値: Region

ZoneId String いいえ RI が属するゾーン ID。 "Scope" が "Zone" に設定されている場合、このパラメーターは必須です。 ゾーンリストについては、「 DescribeZones 」をご参照ください。
ReservedInstanceName String いいえ RI の名前。 名前は 2 ~ 128 文字の長さの文字列で、英数字、コロン (:)、アンダーバー (_)、およびハイフンを含めることができます。 先頭は文字でなければなりません。 http:// または https:// を先頭にしてはいけません。
InstanceType String はい RI のインスタンスタイプ。 詳細については、「インスタンスタイプファミリー」をご参照ください 。
InstanceAmount Integer はい RI に割り当てられたインスタンスの数 (RI は、インスタンスが 1 つ以上割り当てられているクーポンです)。
OfferingType String はい RI の支払いタイプ。 オプションの値:
  • 前払いなし: 前払いは不要です。
  • 一部前払い: 一部前払いが必要です。
  • すべて前払い: 全額前払いが必要です。
Period Integer はい RI の期間。 単位: 年。 省略可能な値: "1" および "3"。
PeriodUnit String はい 期間の単位。 オプションの値: ""。

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

名前 タイプ 説明
ReservedInstanceId String RI の ID。 ID は、RI にアクセスするための一意の ID です。

リクエストの例

https://ecs.aliyuncs.com/?Action=PurchaseReservedInstancesOffering
&RegionId=cn-hangzhou
&Scope=Zone
&ZoneId=cn-hangzhou-a
&ReservedInstanceName=test
&InstanceType=ecs.g5.2xlarge
&InstanceAmount=1
&OfferingType=All Upfront
&Period=1
&PeriodUnit=Year
&<Common request parameters>

レスポンスの例

XML 形式

<PurchaseReservedInstancesOfferingResponse>
    <RequestId>51AB7717-6E1A-4D1D-A44D-54CBxxxxxxxx</RequestId>
    <ReservedInstanceId>ri-instance</InstanceId>
</PurchaseReservedInstancesOfferingResponse>

JSON 形式

{
    "RequestId": "51AB7717-6E1A-4D1D-A44D-54CBxxxxxxxx",
    "ReservedInstanceId":"ri-instance"
}