Mengambil detail semua tipe instans atau tipe instans tertentu yang disediakan oleh Elastic Compute Service (ECS).
Catatan penggunaan
Perhatikan hal-hal berikut:
Parameter MaxResults menentukan jumlah maksimum entri yang dikembalikan per halaman. Nilai maksimum parameter ini diubah dari 1600 menjadi 100. Jika Anda memanggil operasi ini pada tahun 2022, Anda masih dapat menggunakan 1600 sebagai nilai maksimum MaxResults hingga 15 November 2023. Mulai 15 November 2023, hanya nilai 100 yang dapat digunakan sebagai nilai maksimum MaxResults. Jika Anda tidak mengonfigurasi parameter NextToken saat memanggil operasi DescribeInstanceTypes, hanya halaman pertama hasil yang berisi hingga 100 entri yang akan dikembalikan. Jika Anda ingin mengambil lebih banyak hasil, konfigurasikan parameter NextToken untuk melakukan kueri terpaginasi, atau tentukan kondisi filter untuk menyaring hasil.
Kami menyarankan agar Anda menentukan MaxResults dan NextToken untuk melakukan kueri terpaginasi. Saat pertama kali memanggil operasi DescribeInstanceTypes, tentukan MaxResults untuk membatasi jumlah maksimum entri yang dikembalikan dalam panggilan tersebut. Jika jumlah entri yang akan dikembalikan melebihi nilai MaxResults yang ditentukan, respons akan menyertakan nilai NextToken. Anda dapat mengatur NextToken ke nilai tersebut dan menentukan MaxResults dalam permintaan berikutnya ke DescribeInstanceTypes untuk mengambil halaman hasil berikutnya.
Operasi DescribeInstanceTypes hanya digunakan untuk menanyakan informasi spesifikasi dan performa tipe instans. Untuk menanyakan tipe instans yang tersedia di wilayah tertentu, panggil operasi DescribeAvailableResource.
Untuk menggunakan tipe instans khusus seperti tipe instans yang tidak tersedia untuk pembelian, submit a ticket.
Debugging
Parameter permintaan
Parameter | Jenis | Wajib | Contoh | Deskripsi |
Action | String | Ya | DescribeInstanceTypes | Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeInstanceTypes. |
InstanceTypeFamily | String | Tidak | ecs.g6 | Keluarga instans tempat tipe instans tersebut termasuk. Untuk informasi mengenai nilai valid parameter ini, lihat DescribeInstanceTypeFamilies. Untuk informasi lebih lanjut mengenai keluarga instans, lihat Instance families. |
InstanceTypes.N | String | Tidak | ecs.g6.large | Tipe instans N. Nilai valid N: 1 hingga 10. Jika parameter ini dikosongkan, informasi semua tipe instans akan ditanyakan. |
MinimumCpuCoreCount | Integer | Tidak | 2 | Jumlah minimum vCPU. Nilai harus berupa bilangan bulat positif. Catatan Jika jumlah vCPU suatu tipe instans lebih kecil dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MaximumCpuCoreCount | Integer | Tidak | 10 | Jumlah maksimum vCPU. Nilai harus berupa bilangan bulat positif. Catatan Jika jumlah vCPU suatu tipe instans lebih besar dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumMemorySize | Float | Tidak | 20 | Ukuran memori minimum. Satuan: GiB. Catatan Jika ukuran memori suatu tipe instans lebih kecil dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MaximumMemorySize | Float | Tidak | 60 | Ukuran memori maksimum. Satuan: GiB. Catatan Jika ukuran memori suatu tipe instans lebih besar dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumGPUAmount | Integer | Tidak | 3 | Jumlah minimum GPU. Nilai harus berupa bilangan bulat positif. Catatan Jika suatu tipe instans menyediakan GPU lebih sedikit dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MaximumGPUAmount | Integer | Tidak | 10 | Jumlah maksimum GPU. Nilai harus berupa bilangan bulat positif. Catatan Jika suatu tipe instans menyediakan GPU lebih banyak dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
GPUSpec | String | Tidak | NVIDIA V100 | Model GPU. Catatan Pencocokan fuzzy didukung. Misalnya, jika suatu tipe instans menyediakan GPU NVIDIA V100 dan Anda menetapkan parameter ini ke NVIDIA, informasi tipe instans tersebut akan ditanyakan. |
InstanceCategory | String | Tidak | Big data | Kategori tipe instans. Nilai valid:
|
CpuArchitecture | String | Tidak | X86 | Arsitektur CPU. Nilai valid:
|
MinimumCpuSpeedFrequency | Float | Tidak | 2.5 | Kecepatan clock minimum. Catatan Jika suatu tipe instans menggunakan prosesor dengan kecepatan clock lebih rendah dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MaximumCpuSpeedFrequency | Float | Tidak | 3.2 | Kecepatan clock maksimum. Catatan Jika suatu tipe instans menggunakan prosesor dengan kecepatan clock lebih tinggi dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumCpuTurboFrequency | Float | Tidak | 3.2 | Frekuensi turbo minimum. Catatan Jika suatu tipe instans menggunakan prosesor yang memberikan frekuensi turbo lebih rendah dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MaximumCpuTurboFrequency | Float | Tidak | 4.1 | Frekuensi turbo maksimum. Catatan Jika suatu tipe instans menggunakan prosesor yang memberikan frekuensi turbo lebih tinggi dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
PhysicalProcessorModel | String | Tidak | Intel Xeon(Ice Lake) Platinum 8369B | Model CPU. Catatan Pencocokan fuzzy didukung. Misalnya, jika suatu tipe instans menggunakan prosesor Intel Xeon (Ice Lake) Platinum 8369B dan Anda menetapkan parameter ini ke Intel, informasi tipe instans tersebut akan ditanyakan. |
InstanceFamilyLevel | String | Tidak | EntryLevel | Tingkat keluarga instans. Nilai valid:
|
MinimumInstancePpsRx | Long | Tidak | 15 | Laju pengalihan paket inbound minimum melalui jaringan internal. Satuan: pps. Catatan Jika suatu tipe instans menyediakan laju pengalihan paket inbound melalui jaringan internal yang lebih rendah dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumInstancePpsTx | Long | Tidak | 15 | Laju pengalihan paket outbound minimum melalui jaringan internal. Satuan: pps. Catatan Jika suatu tipe instans menyediakan laju pengalihan paket outbound melalui jaringan internal yang lebih rendah dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumInstanceBandwidthRx | Integer | Tidak | 12288 | Bandwidth internal inbound minimum. Satuan: Kbit/s. Catatan Jika suatu tipe instans menyediakan bandwidth internal inbound yang lebih rendah dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumInstanceBandwidthTx | Integer | Tidak | 12288 | Bandwidth internal outbound minimum. Satuan: Kbit/s. Catatan Jika suatu tipe instans menyediakan bandwidth internal outbound yang lebih rendah dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumPrimaryEniQueueNumber | Integer | Tidak | 8 | Jumlah antrian default minimum per antarmuka jaringan elastis (ENI) primer. Catatan Jika suatu tipe instans mendukung lebih sedikit antrian per ENI primer daripada nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumSecondaryEniQueueNumber | Integer | Tidak | 4 | Jumlah antrian default minimum per ENI secondary. Catatan Jika suatu tipe instans mendukung lebih sedikit antrian per ENI secondary daripada nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumEniQuantity | Integer | Tidak | 4 | Jumlah minimum ENI per instans. Catatan Jika suatu tipe instans mendukung lebih sedikit ENI daripada nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumQueuePairNumber | Integer | Tidak | 8 | Jumlah minimum pasangan antrian (QPs) per antarmuka RDMA elastis (ERI). Catatan Jika suatu tipe instans mendukung lebih sedikit QPs per ERI daripada nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumEriQuantity | Integer | Tidak | 0 | Jumlah minimum ERI per instans. Catatan Jika suatu tipe instans mendukung lebih sedikit ERI daripada nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumEniPrivateIpAddressQuantity | Integer | Tidak | 2 | Jumlah minimum alamat IPv4 per ENI. Catatan Jika suatu tipe instans mendukung lebih sedikit alamat IPv4 per ENI daripada nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumEniIpv6AddressQuantity | Integer | Tidak | 2 | Jumlah minimum alamat IPv6 per ENI. Catatan Jika suatu tipe instans mendukung lebih sedikit alamat IPv6 per ENI daripada nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumLocalStorageAmount | Integer | Tidak | 4 | Jumlah minimum disk lokal per instans. Catatan Jika suatu tipe instans mendukung lebih sedikit disk lokal daripada nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumLocalStorageCapacity | Long | Tidak | 40 | Kapasitas setiap disk lokal yang dilampirkan per instans. Satuan: GiB. |
MinimumDiskQuantity | Integer | Tidak | 4 | Jumlah minimum disk cloud per instans. Catatan Jika suatu tipe instans mendukung lebih sedikit disk cloud daripada nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
LocalStorageCategory | String | Tidak | local_ssd_pro | Kategori disk lokal. Untuk informasi lebih lanjut, lihat Local disks. Nilai valid:
|
NvmeSupport | String | Tidak | required | Menentukan apakah disk cloud dapat dilampirkan menggunakan protokol NVMe. Nilai valid:
|
MinimumBaselineCredit | Integer | Tidak | 12 | Performa komputasi vCPU dasar minimum (kinerja dasar keseluruhan semua vCPU) untuk instans burstable t5 atau t6. Catatan Jika suatu tipe instans t5 atau t6 menyediakan performa komputasi vCPU dasar lebih rendah dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MinimumInitialCredit | Integer | Tidak | 12 | Kredit vCPU awal minimum untuk instans burstable t5 atau t6. Catatan Jika suatu tipe instans t5 atau t6 menyediakan kredit vCPU awal lebih sedikit dari nilai yang ditentukan, informasi tipe instans tersebut tidak akan ditanyakan. |
MaxResults | Long | Tidak | 10 | Jumlah entri per halaman. Nilai maksimum: 1600. Nilai default: 1600. |
NextToken | String | Tidak | e71d8a535bd9cc11 | Token paginasi yang digunakan dalam permintaan berikutnya untuk mengambil halaman hasil baru. Anda tidak perlu menentukan parameter ini untuk permintaan pertama. Anda harus menentukan token yang diperoleh dari kueri sebelumnya sebagai nilai NextToken. |
Parameter respons
Parameter | Tipe | Contoh | Deskripsi |
RequestId | String | 00827261-20B7-4562-83F2-4DF39876A45A | ID permintaan. |
InstanceTypes | Array of InstanceType | Detail mengenai tipe instans. | |
InstanceType | |||
EniTotalQuantity | Integer | 0 | Jumlah maksimum ENI, termasuk ENI primer, secondary, dan trunk. Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk umum. |
LocalStorageCategory | String | local_ssd_pro | Kategori disk lokal. Untuk informasi lebih lanjut, lihat Local disks. Nilai valid:
|
PrimaryEniQueueNumber | Integer | 4 | Jumlah antrian default per ENI primer. |
MemorySize | Float | 16 | Ukuran memori. Satuan: GiB. |
LocalStorageCapacity | Long | 5000 | Kapasitas setiap disk lokal. Satuan: GiB. |
InstanceFamilyLevel | String | EnterpriseLevel | Tingkat keluarga instans. Nilai valid:
Untuk informasi lebih lanjut, lihat Overview. |
InstancePpsRx | Long | 500000 | Laju pengalihan paket inbound melalui jaringan internal. Satuan: pps. |
EniIpv6AddressQuantity | Integer | 1 | Jumlah maksimum alamat IPv6 per ENI. |
MaximumQueueNumberPerEni | Integer | 4 | Jumlah maksimum antrian per ENI. ENI dapat berupa ENI primer atau secondary. |
InstanceTypeId | String | ecs.g6.large | ID tipe instans. |
InstanceBandwidthRx | Integer | 1024000 | Bandwidth internal inbound maksimum. Satuan: Kbit/s. |
SecondaryEniQueueNumber | Integer | 4 | Jumlah antrian default per ENI secondary. |
GPUSpec | String | NVIDIA V100 | Model GPU. |
InstanceBandwidthTx | Integer | 1024000 | Bandwidth internal outbound maksimum. Satuan: Kbit/s. |
QueuePairNumber | Integer | 22 | Jumlah maksimum QPs per ERI. |
EriQuantity | Integer | 0 | Jumlah ERI. Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk umum. |
GPUAmount | Integer | 0 | Jumlah GPU. |
TotalEniQueueQuantity | Integer | 12 | Jumlah maksimum antrian pada ENI yang didukung oleh tipe instans. |
NvmeSupport | String | unsupported | Menunjukkan apakah disk cloud dapat dilampirkan menggunakan protokol NVMe. Nilai valid:
|
DiskQuantity | Integer | 17 | Jumlah maksimum disk cloud per instans. |
InitialCredit | Integer | 120 | Kredit vCPU awal untuk instans burstable t5 atau t6. |
LocalStorageAmount | Integer | 1 | Jumlah disk lokal per instans. |
BaselineCredit | Integer | 4 | Performa komputasi vCPU dasar (kinerja keseluruhan semua vCPU) untuk instans burstable t5 atau t6. |
InstancePpsTx | Long | 500000 | Laju pengalihan paket outbound melalui jaringan internal. Satuan: pps. |
EniPrivateIpAddressQuantity | Integer | 10 | Jumlah maksimum alamat IPv4 per ENI. |
CpuCoreCount | Integer | 4 | Jumlah vCPU. |
InstanceTypeFamily | String | ecs.g6 | Keluarga instans. |
EniQuantity | Integer | 3 | Jumlah maksimum ENI. |
EniTrunkSupported | Boolean | true | Menunjukkan apakah ENI trunk didukung. Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk umum. |
CpuSpeedFrequency | Float | 2.7 | Frekuensi dasar CPU. Satuan: GHz. |
CpuTurboFrequency | Float | 3.5 | Frekuensi turbo CPU. Satuan: GHz. |
PhysicalProcessorModel | String | Intel Xeon(Ice Lake) Platinum 8369B | Model CPU. |
NetworkEncryptionSupport | Boolean | true | Menunjukkan apakah traffic jaringan yang dikirimkan melalui virtual private cloud (VPC) dapat dienkripsi. Nilai valid:
|
InstanceCategory | String | Big data | Kategori tipe instans. Nilai valid:
|
CpuArchitecture | String | X86 | Arsitektur CPU. Nilai valid:
|
GPUMemorySize | Float | 32 | Ukuran memori per GPU. Satuan: GiB. |
NetworkCardQuantity | Integer | 1 | Jumlah maksimum kartu jaringan yang didukung oleh tipe instans. |
NetworkCards | Array of NetworkCardInfo | Detail mengenai kartu jaringan. | |
NetworkCardInfo | |||
NetworkCardIndex | Integer | 1 | Indeks kartu jaringan. |
NextToken | String | e71d8a535bd9cc11 | Token kueri yang dikembalikan dalam pemanggilan ini. |
Contoh
Permintaan contoh
https://ecs.aliyuncs.com/?Action=DescribeInstanceTypes
&InstanceTypeFamily=ecs.g6
&InstanceTypes.1=ecs.g6.large
&<Common request parameters>Respons sukses contoh
XML format
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeInstanceTypesResponse>
<RequestId>00827261-20B7-4562-83F2-4DF39876A45A</RequestId>
<NextToken/>
<InstanceTypes>
<InstanceType>
<InstancePpsTx>500000</InstancePpsTx>
<NvmeSupport>unsupported</NvmeSupport>
<PrimaryEniQueueNumber>4</PrimaryEniQueueNumber>
<TotalEniQueueQuantity>12</TotalEniQueueQuantity>
<EniTrunkSupported>true</EniTrunkSupported>
<InstanceTypeFamily>ecs.g6</InstanceTypeFamily>
<InstancePpsRx>500000</InstancePpsRx>
<EriQuantity>0</EriQuantity>
<InstanceBandwidthRx>1024000</InstanceBandwidthRx>
<InstanceBandwidthTx>1024000</InstanceBandwidthTx>
<SecondaryEniQueueNumber>4</SecondaryEniQueueNumber>
<LocalStorageCategory/>
<GPUSpec/>
<InstanceTypeId>ecs.g6.xlarge</InstanceTypeId>
<MemorySize>16</MemorySize>
<MaximumQueueNumberPerEni>4</MaximumQueueNumberPerEni>
<EniIpv6AddressQuantity>1</EniIpv6AddressQuantity>
<EniTotalQuantity>5</EniTotalQuantity>
<CpuCoreCount>4</CpuCoreCount>
<EniQuantity>3</EniQuantity>
<GPUAmount>0</GPUAmount>
<DiskQuantity>17</DiskQuantity>
<QueuePairNumber>22</QueuePairNumber>
<InstanceFamilyLevel>EnterpriseLevel</InstanceFamilyLevel>
<EniPrivateIpAddressQuantity>10</EniPrivateIpAddressQuantity>
<CpuSpeedFrequency>2.7</CpuSpeedFrequency>
<CpuTurboFrequency>3.5</CpuTurboFrequency>
<PhysicalProcessorModel>Intel Xeon(Ice Lake) Platinum 8369B</PhysicalProcessorModel>
<InitialCredit>120</InitialCredit>
</InstanceType>
</InstanceTypes>
</DescribeInstanceTypesResponse>JSON format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "00827261-20B7-4562-83F2-4DF39876A45A",
"NextToken" : "",
"InstanceTypes" : {
"InstanceType" : [ {
"InstancePpsTx" : 500000,
"NvmeSupport" : "unsupported",
"PrimaryEniQueueNumber" : 4,
"TotalEniQueueQuantity" : 12,
"EniTrunkSupported" : true,
"InstanceTypeFamily" : "ecs.g6",
"InstancePpsRx" : 500000,
"EriQuantity" : 0,
"InstanceBandwidthRx" : 1024000,
"InstanceBandwidthTx" : 1024000,
"SecondaryEniQueueNumber" : 4,
"LocalStorageCategory" : "",
"GPUSpec" : "",
"InstanceTypeId" : "ecs.g6.xlarge",
"MemorySize" : 16,
"MaximumQueueNumberPerEni" : 4,
"EniIpv6AddressQuantity" : 1,
"EniTotalQuantity" : 5,
"CpuCoreCount" : 4,
"EniQuantity" : 3,
"GPUAmount" : 0,
"DiskQuantity" : 17,
"QueuePairNumber" : 22,
"InstanceFamilyLevel" : "EnterpriseLevel",
"EniPrivateIpAddressQuantity" : 10,
"CpuSpeedFrequency" : 2.7,
"CpuTurboFrequency" : 3.5,
"PhysicalProcessorModel" : "Intel Xeon(Ice Lake) Platinum 8369B",
"InitialCredit" : "120"
} ]
}
}Kode kesalahan
Untuk daftar kode kesalahan, lihat Service error codes.