您可以調用PurchaseReservedInstancesOffering購買預留執行個體券，以自動匹配對應的物理執行個體，抵扣隨用隨付執行個體賬單。

描述

購買預留執行個體券前，可以調用DescribeAvailableResource查詢可用執行個體資源，建議您提前瞭解預留執行個體券計費方式。

請求參數

名稱 類型 是否必選 描述
Action String 是 系統規定參數。取值： PurchaseReservedInstancesOffering
RegionId String 是 執行個體所屬的地區ID。您可以調用DescribeRegions查看最新的阿里雲地區列表。
Scope String 是 預留執行個體券的範圍。可選值：
  • Region：地區層級
  • Zone：可用性區域層級

預設值：Region。

ZoneId String 否 執行個體所屬的可用性區域編號，當Scope為Zone時必填。更多詳情，請參閱DescribeZones擷取可用性區域列表。
ReservedInstanceName String 否 預留執行個體券的名稱。長度為[2, 128]個英文或中文字元。必須以大小寫字母或中文開頭，不能以 http:// 和 https:// 開頭。可以包含數字、半形冒號（:）、底線（_）或者連字號（-）。
InstanceType String 是 執行個體的資源規格。更多詳情，請參閱執行個體規格類型系列。
InstanceAmount Integer 是 預留執行個體券可以同時匹配同規格隨用隨付執行個體的數量。例如，執行個體規格設定為ecs.g5.large，預留執行個體數量設定為3，該預留執行個體券就可以同時匹配3台規格為ecs.g5.large的隨用隨付執行個體。
OfferingType String 是 預留執行個體券的付款類型。可選值：
  • No Upfront：零預付
  • Partial Upfront：部分預付
  • All Upfront：全預付
Period Integer 是 購買資源的時間長度，單位為：年。可選值：1和3。
PeriodUnit String 是 購買資源的時間長度單位。可選值：Year。

返回參數

名稱 類型 描述
ReservedInstanceId String 預留執行個體券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
&<公用請求參數>

正常返回樣本

XML 格式 

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

JSON 格式 

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