您可以调用DescribeReservedInstances查询已经购买的预留实例券。

请求参数

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

默认值:Region

ZoneId String 实例所属的可用区编号,当ScopeZone时必填。更多详情,请参阅DescribeZones获取可用区列表。
ReservedInstanceName String 预留实例券名称。
ReservedInstanceId List 预留实例券ID。
InstanceType String 实例资源的规格。更多详情,请参阅实例规格族
InstanceTypeFamily String 实例资源的规格族。更多详情,请参阅实例规格族
Status List 预留实例券状态。可选值:
  • Creating:正在创建预留实例券
  • Active:预留实例券在有效期中
  • Expired:预留实例券已过期
  • Updating:正在更改预留实例券的属性
PageNumber Integer 预留实例券列表的页码,起始值:1

默认值:1

PageSize Integer 分页查询时的每页行数,最大值:100

默认值:10

返回参数

名称 类型 描述
RequestId String 请求ID。
TotalCount Integer 预留实例券的总数。
PageNumber Integer 预留实例券列表的页码。
PageSize Integer 输入时设置的每页行数。
ReservedInstances List ReservedInstance组成的数组格式,返回实例的信息。

数据类型ReservedInstance包含的参数如下:

名称 类型 描述
ReservedInstanceName String 预留实例券名称。
RegionId String 预留实例券所属的地域ID。
ZoneId String 预留实例券所属的可用区ID。
InstanceType String 预留实例券匹配的按量付费实例的规格。
Scope String 预留实例券应用的范围。
OfferingType String 预留实例券的付款类型。
InstanceAmount String 预留实例券可以同时匹配同规格按量付费实例的数量。
Status String 预留实例券状态。
CreationTime String 预留实例券的创建时间。
ExpiredTime String 预留实例券的到期时间。
StartTime String 预留实例券的生效时间。

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeReservedInstances
&RegionId=cn-hangzhou
&Scope=Region
&<公共请求参数>

正常返回示例

XML 格式

<DescribeReservedInstancesResponse>
    <ReservedInstance>
	<CreationTime>2018-12-10T12:07Z</CreationTime>
	<ExpiredTime>2019-12-10T16:00Z</ExpiredTime>
	<InstanceAmount>1</InstanceAmount>
	<ReservedInstanceId>ri-xxx</ReservedInstanceId>
	<InstanceType>ecs.g5.large</InstanceType>
	<OfferingType>All Upfront</OfferingType>
	<RegionId>cn-hangzhou</RegionId>
	<ReservedInstanceName>riZ0xzhex2ulpzf53xxxxx</ReservedInstanceName>
	<Scope>region</Scope>
	<StartTime>2018-12-10T12:00Z</StartTime>
	<Status>active</Status>
    </ReservedInstance>
    <ReservedInstance>
	<CreationTime>2018-12-10T12:07Z</CreationTime>
	<ExpiredTime>2019-12-10T16:00Z</ExpiredTime>
	<InstanceAmount>1</InstanceAmount>
	<ReservedInstanceId>ri-xxxx</ReservedInstanceId>
	<InstanceType>ecs.g5.large</InstanceType>
	<OfferingType>All Upfront</OfferingType>
	<RegionId>cn-hangzhou</RegionId>
	<ReservedInstanceName>riZ0xzhex2ulpzfxxxxxx</ReservedInstanceName>
	<Scope>region</Scope>
	<StartTime>2018-12-10T12:00Z</StartTime>
	<Status>active</Status>
    </ReservedInstance>
    <PageNumber>1</PageNumber>
    <PageSize>50</PageSize>
    <Total>2</Total>
</DescribeReservedInstancesResponse>

JSON 格式

{
    "code":"200",
    "data":{
        "data":[
            {
                "CreationTime":"2018-12-10T12:07Z",
                "ExpiredTime":"2019-12-10T16:00Z",
                "InstanceAmount":1,
                "ReservedInstanceId":"ri-0xzhex2ulpzf53rxme2j",
                "InstanceType":"ecs.g5.large",
                "OfferingType":"All Upfront",
                "RegionId":"cn-hangzhou-test-307",
                "ReservedInstanceName":"riZ0xzhex2ulpzf53rxme2jZ",
                "Scope":"region",
                "StartTime":"2018-12-10T12:00Z",
                "Status":"active"
            }
        ],
        "PageNumber":1,
        "PageSize":50,
        "Total":1
    },
    "httpStatusCode":200,
    "message":"successful",
    "requestId":"E572643C-6A29-49D6-9D4E-6CFA4E063A3E",
    "success":true
}