DescribeReservedInstances - - Alibaba Cloud Documentation Center

Menampilkan kueri terhadap instans terjadwal yang telah dibeli.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk memudahkan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Wajib	Contoh	Deskripsi
Action	String	Yes	DescribeReservedInstances	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeReservedInstances.
RegionId	String	Yes	cn-hangzhou	ID wilayah dari instans terjadwal. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.
PageNumber	Integer	No	1	Nomor halaman. Halaman dimulai dari halaman 1. Nilai default: 1.
PageSize	Integer	No	50	Jumlah entri per halaman. Nilai maksimum: 100. Nilai default: 10.
Tag.N.Key	String	No	TestKey	Kunci tag N dari instans terjadwal. Nilai N yang valid: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag maksimal 128 karakter dan tidak boleh diawali dengan acs: atau aliyun. Kunci tag juga tidak boleh mengandung http:// atau https://. Jika Anda menentukan satu tag untuk mengkueri resource, hingga 1.000 resource yang memiliki tag tersebut akan dikembalikan. Jika Anda menentukan beberapa tag untuk mengkueri resource, hingga 1.000 resource yang memiliki semua tag yang ditentukan akan dikembalikan. Untuk mengkueri lebih dari 1.000 resource yang memiliki tag tertentu, panggil operasi ListTagResources.
Tag.N.Value	String	No	TestValue	Nilai tag N dari instans terjadwal. Nilai N yang valid: 1 hingga 20. Nilai tag boleh berupa string kosong. Panjang nilai tag maksimal 128 karakter dan tidak boleh mengandung http:// atau https://. Nilai tag tidak boleh diawali dengan acs:.
ZoneId	String	No	cn-hangzhou-z	ID zona dari instans terjadwal. Parameter ini wajib ditentukan ketika Scope diatur ke Zone. Anda dapat memanggil operasi DescribeZones untuk mengambil daftar zona terbaru.
ReservedInstanceName	String	No	testReservedInstanceName	Nama instans terjadwal.
LockReason	String	No	security	Alasan mengapa instans terjadwal dikunci. Nilai yang valid: financial: mengunci instans terjadwal karena akun memiliki pembayaran tertunda atau layanan telah kedaluwarsa. security: mengunci instans terjadwal karena alasan keamanan.
InstanceType	String	No	ecs.g5.large	Tipe instans dari instans terjadwal. Untuk informasi mengenai nilai-nilainya, lihat Overview of instance families.
InstanceTypeFamily	String	No	ecs.g5	Keluarga instans dari instans terjadwal. Untuk informasi mengenai nilai-nilainya, lihat Overview of instance families.
Scope	String	No	Region	Cakupan instans terjadwal. Nilai yang valid: Region Zone Nilai default: Region.
OfferingType	String	No	All Upfront	Metode penagihan instans terjadwal. Nilai yang valid: No Upfront Partial Upfront All Upfront
AllocationType	String	No	Normal	Tipe alokasi instans terjadwal. Nilai yang valid: Normal: mengkueri semua instans terjadwal yang dimiliki oleh akun saat ini. Shared: mengkueri instans terjadwal yang dibagikan antara akun utama saat ini dan akun terkait. Nilai default: Normal.
ReservedInstanceId.N	String	No	ri-bpzhex2ulpzf53****	ID instans terjadwal N. Nilai N yang valid: 1 hingga 100.
Status.N	String	No	Active	Status instans terjadwal N. Nilai N yang valid: 1 hingga 100. Nilai yang valid: Creating: Instans terjadwal sedang dibuat. Active: Instans terjadwal aktif. Expired: Instans terjadwal telah kedaluwarsa. Updating: Properti instans terjadwal sedang dimodifikasi.

Parameter respons

Parameter	Type	Contoh	Deskripsi
PageSize	Integer	1	Jumlah entri per halaman.
RequestId	String	E572643C-6A29-49D6-9D4E-6CFA4E063A3E	ID permintaan.
PageNumber	Integer	1	Nomor halaman.
TotalCount	Integer	1	Jumlah total instans terjadwal.
ReservedInstances	Array of ReservedInstance		Detail mengenai instans terjadwal.
ReservedInstance
Status	String	Active	Status instans terjadwal.
CreationTime	String	2018-12-10T12:07Z	Waktu saat instans terjadwal dibuat.
ReservedInstanceName	String	riZbpzhex2ulpzf53****	Nama instans terjadwal.
ReservedInstanceId	String	ri-bpzhex2ulpzf53****	ID instans terjadwal.
InstanceType	String	ecs.g5.large	Tipe instans dari instans pay-as-you-go yang sesuai dengan setiap instans terjadwal.
InstanceAmount	Integer	10	Jumlah instans pay-as-you-go yang memiliki tipe instans yang sama dengan instans terjadwal dan dapat dicocokkan dengan instans terjadwal tersebut.
RegionId	String	cn-hangzhou	ID wilayah dari instans terjadwal.
OfferingType	String	All Upfront	Metode penagihan instans terjadwal.
StartTime	String	2018-12-10T12:00Z	Waktu saat instans terjadwal mulai berlaku.
Description	String	testDescription	Deskripsi instans terjadwal.
AllocationStatus	String	allocated	Status alokasi instans terjadwal ketika parameter AllocationType diatur ke Shared. Nilai yang valid: allocated: Instans terjadwal dialokasikan ke akun lain. beAllocated: Instans terjadwal dialokasikan oleh akun lain.
ExpiredTime	String	2019-12-10T12:07Z	Waktu saat instans terjadwal kedaluwarsa.
ResourceGroupId	String	EcsDocTest	ID kelompok sumber daya.
ZoneId	String	cn-hangzhou-z	ID zona.
Platform	String	Linux	Tipe sistem operasi. Nilai yang valid: Windows Linux
Scope	String	region	Cakupan instans terjadwal.
OperationLocks	Array of OperationLock		Detail mengenai status penguncian instans terjadwal.
OperationLock
LockReason	String	security	Alasan mengapa instans terjadwal dikunci.
Tags	Array of Tag		Tag dari instans terjadwal.
Tag
TagValue	String	TestValue	Nilai tag dari instans terjadwal.
TagKey	String	TestKey	Kunci tag dari instans terjadwal.

Contoh

Contoh permintaan

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

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeReservedInstancesResponse>
    <ReservedInstances>
        <ReservedInstance>
            <CreationTime>2018-12-10T12:07Z</CreationTime>
            <ExpiredTime>2019-12-10T16:00Z</ExpiredTime>
            <InstanceAmount>1</InstanceAmount>
            <ReservedInstanceId>ri-0xzhex2ulpzf53****</ReservedInstanceId>
            <InstanceType>ecs.g5.large</InstanceType>
            <OfferingType>All Upfront</OfferingType>
            <RegionId>cn-hangzhou-test-307</RegionId>
            <ReservedInstanceName>riZ0xzhex2ulpzf53****</ReservedInstanceName>
            <Scope>region</Scope>
            <StartTime>2018-12-10T12:00Z</StartTime>
            <Status>Active</Status>
            <Tags>
                <Tag>
                    <TagKey>TestKey</TagKey>
                    <TagValue>TestValue</TagValue>
                </Tag>
            </Tags>
        </ReservedInstance>
    </ReservedInstances>
    <RequestId>E572643C-6A29-49D6-9D4E-6CFA4E063A3E</RequestId>
    <PageNumber>1</PageNumber>
    <PageSize>50</PageSize>
    <Total>1</Total>
</DescribeReservedInstancesResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ReservedInstances" : {
    "ReservedInstance" : [ {
      "CreationTime" : "2018-12-10T12:07Z",
      "ExpiredTime" : "2019-12-10T16:00Z",
      "InstanceAmount" : 1,
      "ReservedInstanceId" : "ri-0xzhex2ulpzf53****",
      "InstanceType" : "ecs.g5.large",
      "OfferingType" : "All Upfront",
      "RegionId" : "cn-hangzhou-test-307",
      "ReservedInstanceName" : "riZ0xzhex2ulpzf53****",
      "Scope" : "region",
      "StartTime" : "2018-12-10T12:00Z",
      "Status" : "Active",
      "Tags" : {
        "Tag" : [ {
          "TagKey" : "TestKey",
          "TagValue" : "TestValue"
        } ]
      }
    } ]
  },
  "RequestId" : "E572643C-6A29-49D6-9D4E-6CFA4E063A3E",
  "PageNumber" : 1,
  "PageSize" : 50,
  "Total" : 1
}

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	MissingParamter.RegionId	The regionId should not be null.	RegionId wajib diisi.
400	InvalidRegion.NotFound	The specified parameter RegionId is not valid.	Nilai RegionId tidak valid.
400	InvalidZone.NotFound	The specified parameter ZoneId is not valid.	Nilai ZoneId tidak valid.
400	InvalidEndTime.ValueNotSupported	The specified endTime is out of the permitted range.	Nilai EndTime tidak valid.
400	InvalidAllocationType.ValueNotSupported	The specified AllocationType is not supported.	Nilai AllocationType tidak valid.
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.	Nilai RegionId tidak ditemukan. Periksa apakah layanan tersedia di wilayah yang ditentukan.

Untuk daftar kode kesalahan, lihat Service error codes.