All Products
Search
Document Center

Elastic Compute Service:DescribeInstanceTypeFamilies

Last Updated:Jun 12, 2026

API ini digunakan untuk meminta daftar kelompok instance yang disediakan oleh Alibaba Cloud ECS. Dengan memanggil API ini, Anda dapat memperoleh informasi tentang kelompok instance dari berbagai generasi untuk lebih memahami sumber daya spesifikasi instance yang tersedia, yang membantu Anda memilih jenis instance yang sesuai saat membuat instance ECS.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID region. Anda dapat memanggil DescribeRegions untuk meminta daftar terbaru region Alibaba Cloud.

cn-hangzhou

Generation

string

No

Generasi dari kelompok instance. Untuk informasi lebih lanjut, lihat Kelompok instance. Nilai yang valid:

  • ecs-1: Kelompok instance ECS Generasi I, yang dirilis lebih awal dan menawarkan efektivitas biaya yang tinggi.

  • ecs-2: Kelompok instance ECS Generasi II, yang telah ditingkatkan untuk kedua kalinya pada perangkat lunak dan perangkat keras serta menawarkan kinerja instance yang ditingkatkan.

  • ecs-3: Kelompok instance ECS Generasi III, yang memberikan kinerja instance yang sangat baik dan memenuhi kebutuhan bisnis yang beragam.

  • ecs-4: Kelompok instance ECS Generasi IV, termasuk kelompok instance tingkat enterprise umum (seperti g5, c5, dan r5), kelompok ECS Bare Metal Instance (seperti ebmc5s, ebmg5s, dan ebmr5s), dan kelompok burstable instance (seperti t5). Kelompok instance ini sangat dapat diadaptasi untuk berbagai skenario, mampu menangani sejumlah besar beban kerja bisnis populer, dan menawarkan latensi yang lebih rendah.

  • ecs-5: Kelompok instance ECS Generasi V, termasuk kelompok instance tingkat enterprise umum (seperti g6, c6, dan r6), kelompok ECS Bare Metal Instance (seperti ebmg6, ebmg6e, dan ebmc6), dan kelompok instance dengan penyimpanan yang ditingkatkan (seperti g6e). Kelompok instance ini memberikan respons lebih cepat dan menawarkan kinerja yang lebih baik.

  • ecs-6: Kelompok instance ECS Generasi VI, termasuk kelompok instance tingkat enterprise (seperti hfc7, hfg7, dan hfr7) dan kelompok ECS Bare Metal Instance (seperti ebmhfg7). Kelompok instance ini berada dalam tahap invitational preview.

ecs-5

Elemen respons

Element

Type

Description

Example

object

ID permintaan.

RequestId

string

ID permintaan.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

InstanceTypeFamilies

object

InstanceTypeFamily

array<object>

Kumpulan kelompok instance (InstanceTypeFamily).

object

Generasi dari kelompok instance.

Generation

string

The series of the instance family.

ecs-5

InstanceTypeFamilyId

string

The ID of the instance family.

ecs.g6

Contoh

Respons sukses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "InstanceTypeFamilies": {
    "InstanceTypeFamily": [
      {
        "Generation": "ecs-5",
        "InstanceTypeFamilyId": "ecs.g6"
      }
    ]
  }
}

Respons error

JSONformat

{
    "RequestId": "540CFF28-407A-40B5-B6A5-74Bxxxxxxxxx", 
    "HostId": "ecs.aliyuncs.com",
    "Code": "IncompleteSignature",
    "Message": "The request signature does not conform to Aliyun standards."
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

404 InvalidRegionId.NotFound The RegionId provided does not exist in our records.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.