購入した RI (リザーブドインスタンス) を照会するには、DescribeReservedInstances を呼び出します。

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

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

デフォルト値: リージョン

ZoneId String いいえ RI が属するゾーンの ID。 "Scope" が "Zone" に設定されている場合、このパラメーターは必須です。 ゾーンリストについては、 「 DescribeZones 」をご参照ください。
ReservedInstanceName String いいえ RI の名前。
ReservedInstanceId List いいえ RI の ID。
InstanceType String いいえ RI のインスタンスタイプ。 詳細については、「インスタンスタイプファミリー」をご参照ください 。
InstanceTypeFamily String いいえ RI のインスタンスタイプファミリー。 詳細については、「インスタンスタイプファミリー」をご参照ください。
Status List いいえ RI のステータス。

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

名前 タイプ 説明
RequestId String リクエスト ID
TotalCount Integer RI の総数。
PageNumber Integer RI リストのページ番号。
PageSize Integer 返された結果に含まれる 1 ページ当たりの行数。
ReservedInstances List インスタンス情報を含む 「 ReservedInstance 」の配列。

次の表に、ReservedInstance データ型のパラメーターを示します。

名前 タイプ 説明
ReservedInstanceName String RI の名前。
RegionId String RI が属するリージョンの ID。
ZoneId String RI が属するゾーンの ID。
InstanceType String RI のインスタンスタイプ。
Scope String RI の範囲。
OfferingType String RI の支払い方法。
InstanceAmount String RI に割り当てられたインスタンスの数 (RI は、インスタンスが 1 つ以上割り当てられているクーポンです)。
Status String RI のステータス。
CreationTime String RI が作成された時刻。
ExpiredTime String RI の有効期限。
StartTime String RI が効力を発する時期。

リクエストの例

https://ecs.aliyuncs.com/?Action=DescribeReservedInstances
&RegionId=cn-hangzhou
&Scope=Region
&<Common request parameters>

レスポンスの例

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
}