您可以调用PurchaseReservedInstancesOffering购买预留实例券,以自动匹配对应的物理实例,抵扣按量付费实例账单。

描述

购买预留实例券前,可以调用DescribeAvailableResource查询可用实例资源,建议您提前了解预留实例券计费方式

请求参数

名称 类型 是否必选 描述
Action String 系统规定参数。取值: PurchaseReservedInstancesOffering
RegionId String 实例所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。
Scope String 预留实例券的范围。可选值:
  • Region:地域级别
  • Zone:可用区级别

默认值:Region

ZoneId String 实例所属的可用区编号,当ScopeZone时必填。更多详情,请参阅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 购买资源的时长,单位为:年。可选值:13
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"
}