DescribeAvailableResource - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

DestinationResource parametresinin değeri, ek parametreler belirtmeniz gerekip gerekmediğini belirler. DestinationResource için aşağıdaki zincirde bir değer seçtiğinizde, seçilen değer sağa doğru ilerledikçe belirtmeniz gereken parametre sayısı artar.

Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk
Örnekler:
- DestinationResource parametresini DataDisk olarak ayarlarsınız.
  - ResourceType parametresini disk olarak ayarlayarak ECS örnek türlerinden bağımsız veri diski kategorilerini sorguluyorsanız InstanceType belirtmenize gerek yoktur.
  - ResourceType parametresini instance olarak ayarlayarak ECS örnekleriyle birlikte satın alınan veri diski kategorilerini sorguluyorsanız, sistem diskleri ve veri diskleri üzerindeki örnek türüne özel kısıtlamalar nedeniyle InstanceType ve SystemDiskCategory parametrelerini belirtmeniz gerekir.
- DestinationResource parametresini SystemDisk ve ResourceType parametresini instance olarak ayarlarsanız, sistem diskleri üzerindeki örnek türüne özel kısıtlamalar nedeniyle InstanceType belirtmeniz gerekir.
- DestinationResource parametresini InstanceType olarak ayarlarsanız IoOptimized ve InstanceType parametrelerini belirtmenizi öneririz.
- China (Hangzhou) bölgesindeki tüm alanlarda bulunan ecs.g5.large kaynaklarını sorgulamak istiyorsanız RegionId parametresini cn-hangzhou, DestinationResource parametresini InstanceType, IoOptimized parametresini optimized ve InstanceType parametresini ecs.g5.large olarak ayarlayın.
- China (Hangzhou) bölgesinde ecs.g5.large kaynaklarının mevcut olduğu alanları sorgulamak istiyorsanız RegionId parametresini cn-hangzhou, DestinationResource parametresini Zone, IoOptimized parametresini optimized ve InstanceType parametresini ecs.g5.large olarak ayarlayın.

Hata ayıklama

OpenAPI Explorer, imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlem örnek kodlarını dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	DescribeAvailableResource	Gerçekleştirmek istediğiniz işlem. Değeri DescribeAvailableResource olarak ayarlayın.
RegionId	String	Evet	cn-hangzhou	Bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
InstanceChargeType	String	Hayır	PrePaid	Kaynağın faturalama yöntemi. Daha fazla bilgi için bkz. Faturalamaya genel bakış. Geçerli değerler: PrePaid: abonelik PostPaid: kullandıkça öde Varsayılan değer: PostPaid.
SpotStrategy	String	Hayır	NoSpot	Kullandıkça öde örnek için teklif ilkesi. Geçerli değerler: NoSpot: Örnek, kullandıkça öde bir örnektir. SpotWithPriceLimit: Örnek, maksimum saatlik fiyatı belirtebileceğiniz öncelikli bir örnek olarak oluşturulur. SpotAsPriceGo: Örnek, satın alma sırasındaki piyasa fiyatına dayalı bir öncelikli örnek olarak oluşturulur. Piyasa fiyatı, kullandıkça öde bir örneğin fiyatına eşit olabilir. Varsayılan değer: NoSpot. Bu parametre yalnızca InstanceChargeType parametresi PostPaid olarak ayarlandığında etkili olur.
SpotDuration	Integer	Hayır	1	Öncelikli örneğin koruma süresi. Birim: saat. Varsayılan değer: 1. Geçerli değerler: 1: Öncelikli bir örnek oluşturulduktan sonra Alibaba Cloud, örneğin 1 saat içinde otomatik olarak serbest bırakılmamasını sağlar. 1 saatlik koruma süresi sona erdikten sonra sistem, teklif fiyatını piyasa fiyatıyla karşılaştırır ve örneğin tutulup tutulmayacağını veya serbest bırakılıp bırakılmayacağını belirlemek için kaynak envanterini kontrol eder. 0: Öncelikli bir örnek oluşturulduktan sonra Alibaba Cloud, örneğin 1 saat çalışmasını garanti etmez. Sistem, teklif fiyatını piyasa fiyatıyla karşılaştırır ve örneğin tutulup tutulmayacağını veya serbest bırakılıp bırakılmayacağını belirlemek için kaynak envanterini kontrol eder. Alibaba Cloud, örnek serbest bırakılmadan 5 dakika önce sizi bilgilendirmek için ECS sistem olayları gönderir. Öncelikli örnekler saniye bazında faturalandırılır. İş gereksinimlerinize göre bir koruma süresi belirtmenizi öneririz. Not SpotStrategy parametresini SpotWithPriceLimit veya SpotAsPriceGo olarak ayarlarsanız bu parametre etkili olur.
DestinationResource	String	Evet	InstanceType	Kaynak türü. Geçerli değerler: Zone: alan. IoOptimized: G/Ç optimize edilmiş kaynak. InstanceType: örnek türü. SystemDisk: sistem diski. DataDisk: veri diski. Network: ağ türü. ddh: ayrılmış ana bilgisayar. DestinationResource parametresinin nasıl belirtileceği hakkında daha fazla bilgi için bu konunun "Kullanım notları" bölümüne bakın.
ZoneId	String	Hayır	cn-hangzhou-e	Alan kimliği. Varsayılan olarak bu parametre boştur. Bu durum, sistemin `RegionId` ile belirtilen bölgedeki tüm alanlarda diğer koşullarla eşleşen kaynakları döndürmesini belirtir.
IoOptimized	String	Hayır	optimized	Örneğin G/Ç optimize edilip edilmediğini belirtir. Geçerli değerler: none: Örnek G/Ç optimize edilmemiştir. optimized: Örnek G/Ç optimize edilmiştir. Varsayılan değer: optimized.
DedicatedHostId	String	Hayır	dh-bp165p6xk2tlw61e****	Ayrılmış ana bilgisayarın kimliği.
InstanceType	String	Hayır	ecs.g5.large	Örnek türü. Daha fazla bilgi için bkz. Örnek ailelerine genel bakış. En güncel örnek türü listesini sorgulamak için DescribeInstanceTypes işlemini de çağırabilirsiniz. InstanceType parametresinin nasıl belirtileceği hakkında daha fazla bilgi için bu konunun Kullanım notları bölümüne bakın.
SystemDiskCategory	String	Hayır	cloud_ssd	Sistem diskinin kategorisi. Geçerli değerler: cloud: temel disk. cloud_efficiency: ultra disk cloud_ssd: standart SSD. ephemeral_ssd: yerel SSD. cloud_essd: ESSD. cloud_auto: ESSD AutoPL disk. Varsayılan değer: cloud_efficiency. Not ResourceType parametresini instance ve DestinationResource parametresini DataDisk olarak ayarlarsanız SystemDiskCategory belirtmeniz gerekir. Bu parametreyi belirtmezseniz varsayılan değer kullanılır.
DataDiskCategory	String	Hayır	cloud_ssd	Veri diskinin türü. Geçerli değerler: cloud: temel disk. cloud_efficiency: ultra disk cloud_ssd: standart SSD. ephemeral_ssd: yerel SSD. cloud_essd: ESSD. cloud_auto: ESSD AutoPL disk.
NetworkCategory	String	Hayır	vpc	Ağ türü. Geçerli değerler: vpc: sanal özel cloud (VPC). classic: klasik ağ.
Cores	Integer	Hayır	2	Örnek türünün sanal CPU (vCPU) sayısı. Daha fazla bilgi için bkz. Örnek ailelerine genel bakış. Bu parametre yalnızca DestinationResource parametresi InstanceType olarak ayarlandığında etkili olur.
Memory	Float	Hayır	8.0	Örnek türünün bellek boyutu. Birim: GiB. Daha fazla bilgi için bkz. Örnek ailelerine genel bakış. Bu parametre yalnızca DestinationResource parametresi InstanceType olarak ayarlandığında etkili olur.
ResourceType	String	Hayır	instance	Kaynak türü. Geçerli değerler: instance: ECS örneği. disk: cloud disk. reservedinstance: ayrılmış örnek. ddh: ayrılmış ana bilgisayar.
Scope	String	Hayır	Region	Ayrılmış örneğin kapsamı. Geçerli değerler: Region: bölgesel. Zone: alansal

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
RequestId	String	0041D94C-FB92-4C49-B115-259DA1C*	İsteğin kimliği.
AvailableZones	AvailableZone dizisi		Sorgulanan alanlar.
AvailableZone
ZoneId	String	cn-hangzhou-e	Alanın kimliği.
Status	String	Available	Alandaki kaynakların durumu. Geçerli değerler: Available SoldOut
StatusCategory	String	WithStock	Stok seviyesine dayalı kaynak kategorisi. Geçerli değerler: WithStock: Kaynaklar yeterlidir. ClosedWithStock: Kaynaklar yetersizdir. Stoku yeterli olan diğer kaynakları kullanmanızı öneririz. WithoutStock: Kaynaklar tükenmiştir ve yeniden doldurulacaktır. Stoku yeterli olan diğer kaynakları kullanmanızı öneririz. ClosedWithoutStock: Kaynaklar tükenmiştir ve yeniden doldurulmayacaktır. Stoku yeterli olan diğer kaynakları kullanmanızı öneririz.
RegionId	String	cn-hangzhou	Bölgenin kimliği.
AvailableResources	AvailableResource dizisi		Alanda mevcut olan kaynaklar.
AvailableResource
Type	String	InstanceType	Kaynak türü. Geçerli değerler: Zone: alan. IoOptimized: G/Ç optimize edilmiş kaynak. InstanceType: örnek türü. SystemDisk: sistem diski. DataDisk: veri diski. Network: ağ türü. ddh: ayrılmış ana bilgisayar.
SupportedResources	SupportedResource dizisi		Sorgulanan kaynaklar.
SupportedResource
Status	String	Available	Kaynağın durumu. Geçerli değerler: Available SoldOut
Value	String	ecs.d1ne.xlarge	Kaynak türü.
Max	Integer	2048	Maksimum disk kapasitesi. Bu parametre yalnızca DestinationResource parametresi SystemDisk veya DataDisk olarak ayarlandığında etkili olur.
Unit	String	GiB	Disk kapasitesinin birimi. Bu parametre yalnızca DestinationResource parametresi SystemDisk veya DataDisk olarak ayarlandığında etkili olur.
StatusCategory	String	WithStock	Stok seviyesine dayalı kaynak kategorisi. Geçerli değerler: WithStock: Kaynaklar yeterlidir. ClosedWithStock: Kaynaklar yetersizdir. Stoku yeterli olan diğer kaynakları kullanmanızı öneririz. WithoutStock: Kaynaklar tükenmiştir ve yeniden doldurulacaktır. Stoku yeterli olan diğer kaynakları kullanmanızı öneririz. ClosedWithoutStock: Kaynaklar tükenmiştir ve yeniden doldurulmayacaktır. Stoku yeterli olan diğer kaynakları kullanmanızı öneririz.
Min	Integer	20	Minimum disk kapasitesi. Bu parametre yalnızca DestinationResource parametresi SystemDisk veya DataDisk olarak ayarlandığında etkili olur.

Örnekler

Örnek istekler

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

Başarılı yanıt örnekleri

XML biçimi

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 biçimi

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"
    } ]
  }
}

Hata kodları

HttpCode	Hata kodu	Hata mesajı	Açıklama
400	Invalid.InstanceChargeType	The specified InstanceChargeType is not valid.	Geçersiz InstanceChargeType değeri.
400	Invalid.Param	The input parameter DestinationResource that is mandatory for processing this request is not supplied.	Geçersiz DestinationResource değeri.
400	InvalidRegionId.MalFormed	The specified parameter RegionId is not valid.	Geçersiz RegionId değeri.
403	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	Geçersiz DedicatedHostId değeri.
404	Invalid.RegionId	The specified RegionId does not exist.	Geçersiz RegionId değeri.
404	Unavailable.Regions	The available regions does not exists	Geçersiz RegionId değeri.
404	Invalid.ResourceType	The ResourceType provided does not exist in our records.	Geçersiz ResourceType değeri.
404	Invalid.DestinationResource	The specified DestinationResource is not valid.	Geçersiz DestinationResource değeri.
404	Invalid.IoOptimized	The specified IoOptimized is not valid.	Geçersiz IoOptimized değeri.
404	Invalid.NetworkCategory	The specified NetworkCategory is not valid.	Geçersiz NetworkCategory değeri.
404	Invalid.SpotStrategy	The specified SpotStrategy is not valid.	Geçersiz SpotStrategy değeri.
404	Invalid.NetworkType	The specified NetworkType is not valid.	Geçersiz NetworkType değeri.
404	InvalidResourceId.NotFound	The specified ResourceId is not found in our records	Geçersiz ResourceId değeri. Kaynağın var olup olmadığını kontrol edin.

Hata kodlarının listesi için bkz. Hizmet hata kodları.