DescribeAvailableResource - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengkueri status inventaris Sumber daya di zona tertentu. Operasi ini terutama digunakan untuk memeriksa apakah Sumber daya target, seperti Tipe instans dan tipe disk sistem, tersedia di zona tertentu sebelum Anda membuat Instans (RunInstances) atau mengubah spesifikasi Instans (ModifyInstanceSpec).

Deskripsi operasi

Parameter DestinationResource memiliki logika dan persyaratan yang berbeda tergantung nilainya. Dalam daftar Pesanan berikut, nilai dengan peringkat lebih rendah memerlukan lebih banyak parameter yang ditetapkan. Anda tidak dapat menggunakan nilai dengan peringkat lebih rendah untuk memfilter Sumber daya dari kategori dengan peringkat lebih tinggi.

Pesanan nilai: Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk
Contoh:
- Jika DestinationResource diatur ke DataDisk:
  - Jika ResourceType diatur ke disk, operasi akan mengkueri tipe disk data yang tidak terkait dengan Tipe instans ECS tertentu. Dalam hal ini, parameter InstanceType bersifat opsional.
  - Jika ResourceType diatur ke instance, operasi akan mengkueri tipe disk data yang dapat dilampirkan ke Instans ECS. Karena Tipe instans memberlakukan batasan pada disk data, Anda harus menentukan InstanceType dan DataDiskCategory.
- Jika DestinationResource diatur ke SystemDisk dan ResourceType diatur ke instance, Anda harus menentukan parameter InstanceType karena Tipe instans ECS memberlakukan batasan pada disk sistem.
- Jika DestinationResource diatur ke InstanceType, tentukan parameter IoOptimized dan InstanceType.
- Kueri inventaris ecs.g5.Tingkat Tinggi di semua zona di Wilayah tertentu: RegionId=ap-southeast-1 &DestinationResource=InstanceType &IoOptimized=optimized &InstanceType=ecs.g5.Tingkat Tinggi.
- Kueri zona di Wilayah tertentu tempat ecs.g5.Tingkat Tinggi tersedia: RegionId=ap-southeast-1 &DestinationResource=Zone &IoOptimized=optimized &InstanceType=ecs.g5.Tingkat Tinggi.

Kueri zona di Wilayah China (Hangzhou) tempat Tipe instans ecs.g5.Tingkat Tinggi tersedia.

"RegionId": "cn-hangzhou",
"DestinationResource": "Zone"，
"InstanceType": "ecs.g5.Tingkat Tinggi"

Kueri inventaris Tipe instans ecs.g5.Tingkat Tinggi di semua zona di Wilayah China (Hangzhou).

"RegionId": "cn-hangzhou",
"DestinationResource": "InstanceType"，
"InstanceType": "ecs.g5.Tingkat Tinggi"

[Hanya membeli disk data] Kueri inventaris tipe disk data cloud_efficiency di Zona B wilayah China (Hangzhou).

"RegionId": "cn-hangzhou",
"ZoneId": "cn-hangzhou-b",
"ResourceType": "disk",
"DestinationResource": "DataDisk"

[Membeli Instans ECS dan disk sistem] Kueri inventaris Tipe instans ecs.g7.Tingkat Tinggi dengan tipe disk sistem cloud_essd di Zona B Wilayah China (Hangzhou).

"RegionId": "cn-hangzhou",
"ZoneId": "cn-hangzhou-b",
"ResourceType": "instance",
"InstanceType": "ecs.g7.Tingkat Tinggi",
"DestinationResource": "SystemDisk",
"SystemDiskCategory": "cloud_essd"

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 wilayah tujuan. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
InstanceChargeType	string	No	Metode penagihan Sumber daya. Untuk informasi selengkapnya, lihat Ikhtisar penagihan. Nilai valid: PrePaid: langganan. PostPaid: bayar sesuai pemakaian. Nilai default: PostPaid.	PrePaid
SpotStrategy	string	No	Kebijakan penawaran untuk instans bayar sesuai pemakaian. Nilai valid: NoSpot: instans bayar sesuai pemakaian reguler. SpotWithPriceLimit: spot instans dengan batas harga maksimum. SpotAsPriceGo: spot instans dengan harga pasar dan harga bayar sesuai pemakaian sebagai batas atas. Nilai default: NoSpot. Parameter ini hanya berlaku jika InstanceChargeType diatur ke `PostPaid`.	NoSpot
SpotDuration	integer	No	Periode perlindungan spot instans. Unit: jam. Nilai default: 1. Nilai valid: 1: Setelah spot instans dibuat, Alibaba Cloud memastikan Instans tidak mengalami pelepasan otomatis dalam 1 jam. Setelah 1 jam, sistem membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris untuk menentukan apakah akan mempertahankan pelepasan otomatis Instans. 0: Setelah spot instans dibuat, Alibaba Cloud tidak memastikan Instans berjalan selama 1 jam. Sistem membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris untuk menentukan apakah akan mempertahankan pelepasan otomatis Instans. Alibaba Cloud mengirimkan notifikasi peristiwa sistem ECS 5 menit sebelum Instans dirilis. Spot instans ditagih per detik. Pilih periode perlindungan yang sesuai berdasarkan durasi eksekusi Tugas yang diharapkan. Catatan Parameter ini hanya berlaku jika `InstanceChargeType` diatur ke `PostPaid` dan `SpotStrategy` diatur ke `SpotWithPriceLimit` atau `SpotAsPriceGo`.	1
DestinationResource	string	Yes	Tipe Sumber daya yang akan dikueri. Nilai valid: Zone: zona. IoOptimized: I/O optimized. InstanceType: Tipe instans. Network: jenis jaringan. ddh: host khusus. SystemDisk: disk sistem. DataDisk: disk data. Catatan Jika DestinationResource diatur ke `SystemDisk`, Anda harus menentukan InstanceType karena disk sistem dibatasi oleh Tipe instans. Untuk informasi selengkapnya tentang cara mengatur parameter DestinationResource, lihat bagian deskripsi operasi pada topik ini.	InstanceType
ZoneId	string	No	ID zona. Nilai default: null. Operasi ini mengembalikan Sumber daya yang sesuai dengan kondisi kueri di semua zona di Wilayah yang ditentukan (RegionId).	cn-hangzhou-e
IoOptimized	string	No	Apakah instans merupakan instans I/O optimized. Nilai valid: none: instans non-I/O optimized. optimized: instans I/O optimized. Nilai default: optimized.	optimized
DedicatedHostId	string	No	ID host khusus.	dh-bp165p6xk2tlw61e****
InstanceType	string	No	Tipe instans. Untuk informasi selengkapnya, lihat family instans. Anda juga dapat memanggil DescribeInstanceTypes untuk mengkueri daftar Tipe instans terbaru. Untuk informasi selengkapnya tentang cara mengatur parameter InstanceType, lihat bagian deskripsi operasi di awal topik ini.	ecs.g5.large
SystemDiskCategory	string	No	Kategori disk sistem. Nilai valid: cloud: disk dasar. cloud_efficiency: disk ultra. cloud_ssd: SSD standar. ephemeral_ssd: SSD lokal. cloud_essd: SSD Perusahaan (ESSD). cloud_auto: disk ESSD AutoPL. Deskripsi nilai default: Jika InstanceType diatur ke tipe instans yang sudah dihentikan, nilai default adalah `cloud`. Dalam kasus lain, nilai default adalah `cloud_efficiency`. Catatan Jika ResourceType diatur ke instance dan DestinationResource diatur ke DataDisk, parameter SystemDiskCategory wajib diisi. Jika Anda tidak menentukan parameter ini, nilai default akan berlaku.	cloud_ssd
DataDiskCategory	string	No	Kategori disk data. Nilai valid: cloud: disk dasar. cloud_efficiency: disk ultra. cloud_ssd: SSD standar. ephemeral_ssd: SSD lokal. cloud_essd: SSD Perusahaan (ESSD). cloud_auto: disk ESSD AutoPL.	cloud_ssd
NetworkCategory	string	No	Jenis jaringan. Nilai valid: vpc: virtual private cloud (VPC). classic: jaringan klasik. Jaringan klasik telah dihentikan. Untuk informasi selengkapnya, lihat Pemberitahuan penghentian.	vpc
Cores	integer	No	Jumlah inti vCPU Tipe instans. Untuk nilai valid, lihat family instans. Parameter ini hanya berlaku jika DestinationResource diatur ke InstanceType.	2
Memory	number	No	Ukuran memori Tipe instans. Unit: GiB. Untuk nilai valid, lihat family instans. Parameter ini hanya berlaku jika DestinationResource diatur ke InstanceType.	8.0
ResourceType	string	No	Tipe Sumber daya. Nilai valid: instance: Instans ECS. disk: cloud disk. reservedinstance: Instans terjadwal. ddh: host khusus.	instance
Scope	string	No	Cakupan Instans terjadwal. Nilai valid: Wilayah: regional. Zona: zonal.	Region

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	0041D94C-FB92-4C49-B115-259DA1C*****
AvailableZones	object
AvailableZone	array<object>	Kumpulan informasi inventaris zona.
	array<object>	Informasi inventaris zona.
ZoneId	string	ID zona.	cn-hangzhou-e
Status	string	Deskripsi status zona. Nilai yang valid: Available: Sumber daya tersedia, yang menunjukkan bahwa zona memiliki setidaknya satu jenis sumber daya yang tersedia, tidak terbatas pada jenis sumber daya yang ditentukan. SoldOut: Sumber daya terjual habis, yang menunjukkan bahwa tidak ada sumber daya yang tersedia di zona tersebut.	Available
StatusCategory	string	Deskripsi rinci tentang status zona berdasarkan situasi inventaris. Nilai yang valid: WithStock: Sumber daya ada dalam stok dan akan terus diisi ulang. ClosedWithStock: Sumber daya ada dalam stok tetapi tidak akan diisi ulang. WithoutStock: Sumber daya terjual habis dan akan diisi ulang. Kami menyarankan Anda memilih spesifikasi produk dalam status WithStock. ClosedWithoutStock: Sumber daya terjual habis dan tidak akan diisi ulang. Pilih spesifikasi produk dalam status WithStock.	WithStock
RegionId	string	ID region.	cn-hangzhou
AvailableResources	object
AvailableResource	array<object>	Array yang terdiri dari sumber daya spesifik yang tersedia untuk dibuat.
	array<object>	Kumpulan sumber daya spesifik yang tersedia untuk dibuat.
Type	string	Jenis sumber daya. Nilai yang valid: Zone: zona. IoOptimized: optimasi I/O. InstanceType: tipe instance. SystemDisk: disk sistem. DataDisk: disk data. Network: tipe jaringan. ddh: dedicated host.	InstanceType
SupportedResources	object
SupportedResource	array<object>	Array yang terdiri dari sumber daya yang didukung yang tersedia untuk dibuat.
	object	Informasi tentang sumber daya yang didukung yang tersedia untuk dibuat.
Status	string	Deskripsi status jenis sumber daya spesifik. Nilai yang valid: Available: Sumber daya tersedia. SoldOut: Sumber daya terjual habis.	Available
Value	string	Nilai sumber daya.	ecs.d1ne.xlarge
Max	integer	Nilai maksimum dari rentang kapasitas disk. Catatan Parameter ini berlaku hanya jika DestinationResource diatur ke `SystemDisk` atau `DataDisk`.	2048
Unit	string	Unit kapasitas disk. Catatan Parameter ini berlaku hanya jika DestinationResource diatur ke `SystemDisk` atau `DataDisk`.	GiB
StatusCategory	string	Deskripsi rinci tentang status sumber daya berdasarkan situasi inventaris. Nilai yang valid: WithStock: Sumber daya ada dalam stok dan akan terus diisi ulang. ClosedWithStock: Sumber daya ada dalam stok tetapi tidak akan diisi ulang. WithoutStock: Sumber daya terjual habis dan akan diisi ulang. Kami menyarankan Anda memilih spesifikasi produk dalam status WithStock. ClosedWithoutStock: Sumber daya terjual habis dan tidak akan diisi ulang. Pilih spesifikasi produk dalam status WithStock.	WithStock
Min	integer	Nilai minimum dari rentang kapasitas disk. Catatan Parameter ini berlaku hanya jika DestinationResource diatur ke `SystemDisk` atau `DataDisk`.	20

Contoh

Respons sukses

JSONformat

{
  "RequestId": "0041D94C-FB92-4C49-B115-259DA1C*****",
  "AvailableZones": {
    "AvailableZone": [
      {
        "ZoneId": "cn-hangzhou-e",
        "Status": "Available",
        "StatusCategory": "WithStock",
        "RegionId": "cn-hangzhou",
        "AvailableResources": {
          "AvailableResource": [
            {
              "Type": "InstanceType",
              "SupportedResources": {
                "SupportedResource": [
                  {
                    "Status": "Available",
                    "Value": "ecs.d1ne.xlarge",
                    "Max": 2048,
                    "Unit": "GiB",
                    "StatusCategory": "WithStock",
                    "Min": 20
                  }
                ]
              }
            }
          ]
        }
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.
400	Invalid.Param	The input parameter DestinationResource that is mandatory for processing this request is not supplied.
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.
403	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.
403	InvalidParam.TypeAndCpuMem.Conflict	The specified 'InstanceType' and 'Cores','Memory' are not blank at the same time.
403	InvalidParam.Cores	The specified parameter 'Cores' should be empty.
403	InvalidParam.Memory	The specified parameter 'Memory' should be empty.
403	InvalidParameter.Scope	The specified parameter Scope is invalid.
403	OperationDenied.RegionIdNotSupported	The region does not support preemptible instances.
403	OperationDenied.FlavorNotSupported	The flavor does not support preemptible instances.
403	OperationDenied.TimestampNotSupported	Preemptible instances are not for sale for current time.
403	InvalidParameter.ResourceOwnerId	The specified parameter ResourceOwnerId is not available anymore.
404	Invalid.RegionId	The specified RegionId does not exist.
404	Unavailable.Regions	The available region does not exist.
404	Invalid.ResourceType	The ResourceType provided does not exist in our records.
404	Invalid.DestinationResource	The specified DestinationResource is not valid.
404	Invalid.IoOptimized	The specified IoOptimized is not valid.
404	Invalid.NetworkCategory	The specified NetworkCategory is not valid.
404	Invalid.SpotStrategy	The specified SpotStrategy is not valid.
404	Invalid.NetworkType	The specified NetworkType is not valid.
404	InvalidResourceId.NotFound	The specified ResourceId is not found in our records.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.
404	InvalidDedicatedHostId.NotFound	The specified Dedicated Host does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.