All Products
Search

This Product

    :DescribeAvailableResource

    Document Center

    :DescribeAvailableResource

    Last Updated:May 22, 2026

    Kueri resource di suatu zona. Anda dapat mengkueri resource yang tersedia di suatu zona sebelum membuat Instance ECS dengan memanggil operasi RunInstances atau sebelum mengubah tipe instans dengan memanggil operasi ModifyInstanceSpec.

    Catatan penggunaan

    Nilai DestinationResource menentukan apakah Anda perlu menentukan parameter tambahan. Semakin ke kanan nilai yang dipilih dalam rantai berikut untuk DestinationResource, semakin banyak parameter yang harus Anda tentukan.

    • Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk

    • Contoh:

      • Anda menetapkan DestinationResource ke DataDisk.

        • Jika Anda menetapkan ResourceType ke disk untuk mengkueri kategori data disk yang independen dari tipe Instance ECS, Anda tidak perlu menentukan InstanceType.

        • Jika Anda menetapkan ResourceType ke instance untuk mengkueri kategori data disk yang dibeli bersama Instance ECS, Anda harus menentukan InstanceType dan SystemDiskCategory karena adanya batasan spesifik tipe instans pada sistem disk dan data disk.

      • Jika Anda menetapkan DestinationResource ke SystemDisk dan ResourceType ke instance, Anda harus menentukan InstanceType karena adanya batasan spesifik tipe instans pada sistem disk.

      • Jika Anda menetapkan DestinationResource ke InstanceType, kami menyarankan agar Anda menentukan IoOptimized dan InstanceType.

      • Jika Anda ingin mengkueri resource ecs.g5.large yang tersedia di semua zona di wilayah China (Hangzhou), tetapkan RegionId ke cn-hangzhou, DestinationResource ke InstanceType, IoOptimized ke optimized, dan InstanceType ke ecs.g5.large.

      • Jika Anda ingin mengkueri zona di wilayah China (Hangzhou) tempat resource ecs.g5.large tersedia, tetapkan RegionId ke cn-hangzhou, DestinationResource ke Zone, IoOptimized ke optimized, dan InstanceType ke ecs.g5.large.

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan 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

    Tipe

    Wajib

    Contoh

    Deskripsi

    Action

    String

    Ya

    DescribeAvailableResource

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeAvailableResource.

    RegionId

    String

    Ya

    cn-hangzhou

    ID wilayah. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.

    InstanceChargeType

    String

    Tidak

    PrePaid

    Metode penagihan resource. Untuk informasi selengkapnya, lihat Ikhtisar penagihan. Nilai yang valid:

    • PrePaid: subscription

    • PostPaid: pay-as-you-go

    Nilai default: PostPaid.

    SpotStrategy

    String

    Tidak

    NoSpot

    Kebijakan penawaran untuk instans pay-as-you-go. Nilai yang valid:

    • NoSpot: Instans merupakan instans pay-as-you-go.

    • SpotWithPriceLimit: Instans dibuat sebagai instans preemptible yang memungkinkan Anda menentukan harga maksimum per jam.

    • SpotAsPriceGo: Instans dibuat sebagai instans preemptible yang harganya didasarkan pada harga pasar saat pembelian. Harga pasar dapat sama dengan harga instans pay-as-you-go.

    Nilai default: NoSpot.

    Parameter ini hanya berlaku jika Anda menetapkan InstanceChargeType ke PostPaid.

    SpotDuration

    Integer

    Tidak

    1

    Periode perlindungan instans preemptible. Satuan: jam. Nilai default: 1. Nilai yang valid:

    • 1: Setelah instans preemptible dibuat, Alibaba Cloud menjamin bahwa instans tersebut tidak akan dilepas secara otomatis dalam waktu 1 jam. Setelah periode perlindungan 1 jam berakhir, sistem akan membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris resource untuk menentukan apakah instans akan dipertahankan atau dilepas.

    • 0: Setelah instans preemptible dibuat, Alibaba Cloud tidak menjamin bahwa instans tersebut akan berjalan selama 1 jam. Sistem akan membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris resource untuk menentukan apakah instans akan dipertahankan atau dilepas.

    Alibaba Cloud mengirimkan peristiwa sistem ECS untuk memberi tahu Anda 5 menit sebelum instans dilepas. Instans preemptible ditagih per detik. Kami menyarankan agar Anda menentukan periode perlindungan sesuai kebutuhan bisnis Anda.

    Catatan

    Jika Anda menetapkan SpotStrategy ke SpotWithPriceLimit atau SpotAsPriceGo, parameter ini berlaku.

    DestinationResource

    String

    Ya

    InstanceType

    Jenis resource. Nilai yang valid:

    • Zone: zona.

    • IoOptimized: resource Optimasi I/O.

    • InstanceType: tipe instans.

    • SystemDisk: disk sistem.

    • DataDisk: data disk.

    • Network: jenis jaringan.

    • ddh: dedicated host.

    Untuk informasi selengkapnya tentang cara menentukan DestinationResource, lihat bagian "Catatan penggunaan" topik ini.

    ZoneId

    String

    Tidak

    cn-hangzhou-e

    ID zona.

    Secara default, parameter ini kosong. Hal ini berarti sistem akan mengembalikan resource yang sesuai dengan kondisi lain di semua zona dalam wilayah yang ditentukan oleh RegionId.

    IoOptimized

    String

    Tidak

    optimized

    Menentukan apakah instans dioptimalkan I/O. Nilai yang valid:

    • none: Instans tidak dioptimalkan I/O.

    • optimized: Instans dioptimalkan I/O.

    Nilai default: optimized.

    DedicatedHostId

    String

    Tidak

    dh-bp165p6xk2tlw61e****

    ID dedicated host.

    InstanceType

    String

    Tidak

    ecs.g5.large

    Tipe instans. Untuk informasi selengkapnya, lihat Ikhtisar keluarga instans. Anda juga dapat memanggil operasi DescribeInstanceTypes untuk mengkueri daftar tipe instans terbaru.

    Untuk informasi selengkapnya tentang cara menentukan InstanceType, lihat bagian Catatan penggunaan topik ini.

    SystemDiskCategory

    String

    Tidak

    cloud_ssd

    Kategori disk sistem. Nilai yang valid:

    • cloud: disk dasar.

    • cloud_efficiency: disk ultra

    • cloud_ssd: SSD standar.

    • ephemeral_ssd: SSD lokal.

    • cloud_essd: ESSD.

    • cloud_auto: ESSD AutoPL disk.

    Nilai default: cloud_efficiency.

    Catatan

    Jika Anda menetapkan ResourceType ke instance dan DestinationResource ke DataDisk, Anda harus menentukan SystemDiskCategory. Jika Anda tidak menentukan parameter ini, nilai default akan digunakan.

    DataDiskCategory

    String

    Tidak

    cloud_ssd

    Jenis data disk. Nilai yang valid:

    • cloud: disk dasar.

    • cloud_efficiency: disk ultra

    • cloud_ssd: SSD standar.

    • ephemeral_ssd: SSD lokal.

    • cloud_essd: ESSD.

    • cloud_auto: ESSD AutoPL disk.

    NetworkCategory

    String

    Tidak

    vpc

    Jenis jaringan. Nilai yang valid:

    • vpc: virtual private cloud (VPC).

    • classic: jaringan klasik.

    Cores

    Integer

    Tidak

    2

    Jumlah vCPU dari tipe instans. Untuk informasi selengkapnya, lihat Ikhtisar keluarga instans.

    Parameter ini hanya berlaku jika Anda menetapkan DestinationResource ke InstanceType.

    Memory

    Float

    Tidak

    8.0

    Ukuran memori tipe instans. Satuan: GiB. Untuk informasi selengkapnya, lihat Ikhtisar keluarga instans.

    Parameter ini hanya berlaku jika Anda menetapkan DestinationResource ke InstanceType.

    ResourceType

    String

    Tidak

    instance

    Jenis resource. Nilai yang valid:

    • instance: Instance ECS.

    • disk: cloud disk.

    • reservedinstance: reserved instance.

    • ddh: dedicated host.

    Scope

    String

    Tidak

    Region

    Cakupan reserved instance. Nilai yang valid:

    • Region: regional.

    • Zone: zonal

    Parameter respons

    Parameter

    Tipe

    Contoh

    Deskripsi

    RequestId

    String

    0041D94C-FB92-4C49-B115-259DA1C*****

    ID permintaan.

    AvailableZones

    Array of AvailableZone

    Zona yang dikueri.

    AvailableZone

    ZoneId

    String

    cn-hangzhou-e

    ID zona.

    Status

    String

    Available

    Status resource di zona. Nilai yang valid:

    • Available

    • SoldOut

    StatusCategory

    String

    WithStock

    Kategori resource berdasarkan tingkat stok. Nilai yang valid:

    • WithStock: Resource mencukupi.

    • ClosedWithStock: Resource tidak mencukupi. Kami menyarankan agar Anda menggunakan resource lain yang memiliki stok mencukupi.

    • WithoutStock: Resource habis terjual dan akan diisi ulang. Kami menyarankan agar Anda menggunakan resource lain yang memiliki stok mencukupi.

    • ClosedWithoutStock: Resource habis terjual dan tidak akan diisi ulang. Kami menyarankan agar Anda menggunakan resource lain yang memiliki stok mencukupi.

    RegionId

    String

    cn-hangzhou

    ID wilayah.

    AvailableResources

    Array of AvailableResource

    Resource yang tersedia di zona.

    AvailableResource

    Type

    String

    InstanceType

    Jenis resource. Nilai yang valid:

    • Zone: zona.

    • IoOptimized: resource Optimasi I/O.

    • InstanceType: tipe instans.

    • SystemDisk: disk sistem.

    • DataDisk: data disk.

    • Network: jenis jaringan.

    • ddh: dedicated host.

    SupportedResources

    Array of SupportedResource

    Resource yang dikueri.

    SupportedResource

    Status

    String

    Available

    Status resource. Nilai yang valid:

    • Available

    • SoldOut

    Value

    String

    ecs.d1ne.xlarge

    Jenis resource.

    Max

    Integer

    2048

    Kapasitas disk maksimum.

    Parameter ini hanya berlaku jika Anda menetapkan DestinationResource ke SystemDisk atau DataDisk.

    Unit

    String

    GiB

    Unit kapasitas disk.

    Parameter ini hanya berlaku jika Anda menetapkan DestinationResource ke SystemDisk atau DataDisk.

    StatusCategory

    String

    WithStock

    Kategori resource berdasarkan tingkat stok. Nilai yang valid:

    • WithStock: Resource mencukupi.

    • ClosedWithStock: Resource tidak mencukupi. Kami menyarankan agar Anda menggunakan resource lain yang memiliki stok mencukupi.

    • WithoutStock: Resource habis terjual dan akan diisi ulang. Kami menyarankan agar Anda menggunakan resource lain yang memiliki stok mencukupi.

    • ClosedWithoutStock: Resource habis terjual dan tidak akan diisi ulang. Kami menyarankan agar Anda menggunakan resource lain yang memiliki stok mencukupi.

    Min

    Integer

    20

    Kapasitas disk minimum.

    Parameter ini hanya berlaku jika Anda menetapkan DestinationResource ke SystemDisk atau DataDisk.

    Contoh

    Contoh permintaan

    https://ecs.aliyuncs.com/?Action=DescribeAvailableResource
&RegionId=cn-hangzhou
&DestinationResource=InstanceType
&IoOptimized=optimized
&InstanceType=ecs.g5.large
&<Common request parameters>

    Contoh respons sukses

    XML format

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

<DescribeAvailableResourceResponse>
    <RequestId>0041D94C-FB92-4C49-B115-259DA1C*****</RequestId>
    <AvailableZones>
        <AvailableZone>
            <Status>Available</Status>
            <RegionId>cn-hangzhou</RegionId>
            <AvailableResources>
                <AvailableResource>
                    <Type>InstanceType</Type>
                    <SupportedResources>
                        <SupportedResource>
                            <Status>Available</Status>
                            <Value>ecs.g5.large</Value>
                            <StatusCategory>WithStock</StatusCategory>
                        </SupportedResource>
                    </SupportedResources>
                </AvailableResource>
            </AvailableResources>
            <ZoneId>cn-hangzhou-i</ZoneId>
            <StatusCategory>WithStock</StatusCategory>
        </AvailableZone>
    </AvailableZones>
</DescribeAvailableResourceResponse>

    JSON format

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

{
  "RequestId" : "0041D94C-FB92-4C49-B115-259DA1C*****",
  "AvailableZones" : {
    "AvailableZone" : [ {
      "Status" : "Available",
      "RegionId" : "cn-hangzhou",
      "AvailableResources" : {
        "AvailableResource" : [ {
          "Type" : "InstanceType",
          "SupportedResources" : {
            "SupportedResource" : [ {
              "Status" : "Available",
              "Value" : "ecs.g5.large",
              "StatusCategory" : "WithStock"
            } ]
          }
        } ]
      },
      "ZoneId" : "cn-hangzhou-i",
      "StatusCategory" : "WithStock"
    } ]
  }
}

    Kode kesalahan

    HttpCode

    Kode kesalahan

    Pesan kesalahan

    Deskripsi

    400

    Invalid.InstanceChargeType

    The specified InstanceChargeType is not valid.

    Nilai InstanceChargeType tidak valid.

    400

    Invalid.Param

    The input parameter DestinationResource that is mandatory for processing this request is not supplied.

    Nilai DestinationResource tidak valid.

    400

    InvalidRegionId.MalFormed

    The specified parameter RegionId is not valid.

    Nilai RegionId tidak valid.

    403

    InvalidDedicatedHostId.NotFound

    The specified DedicatedHostId does not exist.

    Nilai DedicatedHostId tidak valid.

    404

    Invalid.RegionId

    The specified RegionId does not exist.

    Nilai RegionId tidak valid.

    404

    Unavailable.Regions

    The available regions does not exists

    Nilai RegionId tidak valid.

    404

    Invalid.ResourceType

    The ResourceType provided does not exist in our records.

    Nilai ResourceType tidak valid.

    404

    Invalid.DestinationResource

    The specified DestinationResource is not valid.

    Nilai DestinationResource tidak valid.

    404

    Invalid.IoOptimized

    The specified IoOptimized is not valid.

    Nilai IoOptimized tidak valid.

    404

    Invalid.NetworkCategory

    The specified NetworkCategory is not valid.

    Nilai NetworkCategory tidak valid.

    404

    Invalid.SpotStrategy

    The specified SpotStrategy is not valid.

    Nilai SpotStrategy tidak valid.

    404

    Invalid.NetworkType

    The specified NetworkType is not valid.

    Nilai NetworkType tidak valid.

    404

    InvalidResourceId.NotFound

    The specified ResourceId is not found in our records

    Nilai ResourceId tidak valid. Periksa apakah resource tersebut ada.

    Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.