Tüm Ürünler
Search
Belge Merkezi

:DescribeSpotPriceHistory

Son Güncelleme:Sep 29, 2026

Son 30 gün içindeki öncelikli ödemeli bir örneğin fiyat geçmişini sorgular.

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 kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre

Tür

Gerekli

Örnek

Açıklama

Action String Evet DescribeSpotPriceHistory

Gerçekleştirmek istediğiniz işlem. Değeri DescribeSpotPriceHistory olarak ayarlayın.

RegionId String Evet cn-hangzhou

Örneğin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

ZoneId String Hayır cn-hangzhou-g

Örneğin alan kimliği.

NetworkType String Evet vpc

Öncelikli ödemeli örneğin ağ türü. Geçerli değerler:

  • classic
  • vpc
InstanceType String Evet ecs.t1.xsmall

Örneğin örnek türü.

SpotDuration Integer Hayır 1

Öncelikli ödemeli örneğin koruma süresi. Birim: saat. Varsayılan değer: 1. Geçerli değerler:

  • 1: Öncelikli ödemeli bir örnek oluşturulduktan sonra Alibaba Cloud, örneğin 1 saat içinde otomatik olarak serbest bırakılmamasını garanti eder. 1 saatlik koruma süresi sona erdikten sonra sistem, teklif fiyatını piyasa fiyatıyla karşılaştırır ve kaynağı tutup tutmama veya serbest bırakma kararını vermek için kaynak envanterini kontrol eder.
  • 0: Öncelikli ödemeli 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 kaynağı tutup tutmama veya serbest bırakma kararını vermek için kaynak envanterini kontrol eder.

Alibaba Cloud, örnek serbest bırakılmadan 5 dakika önce sizi bilgilendirmek üzere Elastic Compute Service (ECS) sistem olayları gönderir. Öncelikli ödemeli ö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.
IoOptimized String Hayır optimized

Örneğin G/Ç optimize edilmiş olup olmadığını belirtir. Geçerli değerler:

  • optimized: Örnek G/Ç optimize edilmiştir.
  • none: Örnek G/Ç optimize edilmemiştir.

Birinci nesil örnek aileleri için varsayılan değer none'dır.

Diğer örnek aileleri için varsayılan değer optimized'dir.

StartTime String Hayır 2017-08-22T08:45:08Z

Sorgulanacak zaman aralığının başlangıcı. Zamanı, yyyy-MM-ddTHH:mm:ssZ biçiminde ISO 8601 standardına göre belirtin. Saat UTC cinsinden olmalıdır.

Varsayılan olarak bu parametre boştur. Bu, EndTime tarafından belirtilen saatten 3 saat daha önceki zamanın kullanıldığı anlamına gelir.

EndTime String Hayır 2017-08-22T08:45:08Z

Sorgunun bitiş zamanı. Zamanı, yyyy-MM-ddTHH:mm:ssZ biçiminde ISO 8601 standardına göre belirtin. Saat UTC cinsinden olmalıdır.

Varsayılan olarak bu parametre boştur. Bu, geçerli zamanın kullanıldığı anlamına gelir.

OSType String Hayır linux

İşletim sistemi platformunun türü. Geçerli değerler:

  • linux
  • windows
Offset Integer Hayır 0

Sorgunun başladığı satır.

Varsayılan değer: 0.

Yanıt parametreleri

Parametre

Tür

Örnek

Açıklama

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

İsteğin kimliği.

Currency String CNY

Fiyatın para birimi.

Alibaba Cloud Çin sitesi (aliyun.com): CNY

Alibaba Cloud Uluslararası sitesi (alibabacloud.com): USD.

NextOffset Integer 1000

Sonraki sayfanın başlangıç satırı. Offset değeridir.

SpotPrices Array of SpotPriceType

Spot fiyatların ayrıntıları.

SpotPriceType
IoOptimized String optimized

Öncelikli ödemeli örneğin G/Ç optimize edilmiş olup olmadığını gösterir.

ZoneId String cn-hangzhou-c

Öncelikli ödemeli örneğin alan kimliği.

SpotPrice Float 0.036

Öncelikli ödemeli örneğin spot fiyatı.

Timestamp String 2019-11-19T06:00:00Z

Sorgulanan spot fiyata karşılık gelen zaman. Zaman, YYYY-MM-DDThh:mm:ss biçiminde ISO 8601 standardını izler. Zaman UTC olarak görüntülenir.

NetworkType String vpc

Öncelikli ödemeli örneğin ağ türü.

InstanceType String ecs.g5.large

Öncelikli ödemeli örneğin örnek türü.

OriginPrice Float 0.354

Belirtilen öncelikli ödemeli örnek ile aynı yapılandırmaya sahip kullandıkça öde bir örnek için fiyat.

Örnekler

Örnek istekler

https://ecs.aliyuncs.com/?Action=DescribeSpotPriceHistory
&NetworkType=vpc
&RegionId=cn-hangzhou
&InstanceType=ecs.g5.large
&StartTime=2019-11-19T00:00:00Z
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

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

<DescribeSpotPriceHistoryResponse>
    <RequestId>5E2D59BA-4EB0-45C4-A0D7-D98C1A4B320B</RequestId>
    <SpotPrices>
        <SpotPriceType>
            <IoOptimized>optimized</IoOptimized>
            <OriginPrice>0.354</OriginPrice>
            <NetworkType>vpc</NetworkType>
            <ZoneId>cn-hangzhou-g</ZoneId>
            <Timestamp>2019-11-19T06:00:00Z</Timestamp>
            <SpotPrice>0.036</SpotPrice>
            <InstanceType>ecs.g5.large</InstanceType>
        </SpotPriceType>
        <SpotPriceType>
            <IoOptimized>optimized</IoOptimized>
            <OriginPrice>0.354</OriginPrice>
            <NetworkType>vpc</NetworkType>
            <ZoneId>cn-hangzhou-g</ZoneId>
            <Timestamp>2019-11-19T07:00:00Z</Timestamp>
            <SpotPrice>0.036</SpotPrice>
            <InstanceType>ecs.g5.large</InstanceType>
        </SpotPriceType>
    </SpotPrices>
    <Currency>CNY</Currency>
</DescribeSpotPriceHistoryResponse>

JSON biçimi

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

{
  "RequestId" : "5E2D59BA-4EB0-45C4-A0D7-D98C1A4B320B",
  "SpotPrices" : {
    "SpotPriceType" : [ {
      "IoOptimized" : "optimized",
      "OriginPrice" : 0.354,
      "NetworkType" : "vpc",
      "ZoneId" : "cn-hangzhou-g",
      "Timestamp" : "2019-11-19T06:00:00Z",
      "SpotPrice" : 0.036,
      "InstanceType" : "ecs.g5.large"
    }, {
      "IoOptimized" : "optimized",
      "OriginPrice" : 0.354,
      "NetworkType" : "vpc",
      "ZoneId" : "cn-hangzhou-g",
      "Timestamp" : "2019-11-19T07:00:00Z",
      "SpotPrice" : 0.036,
      "InstanceType" : "ecs.g5.large"
    } ]
  },
  "Currency" : "CNY"
}

Hata kodları

HttpCode

Hata kodu

Hata mesajı

Açıklama

400

MissingParameter

%s

Gerekli bir parametre belirtilmemiş.

400

UnsupportedParameter

%s

Belirtilen bir parametre desteklenmiyor.

400

InvalidParameter

%s

Geçersiz parametre değeri.

400

InvalidInstanceID.Malformed

%s

Geçersiz InstanceId biçimi.

400

InvalidParams.StartTime

%s

Geçersiz StartTime değeri.

400

InvalidParams.EndTime

%s

Belirtilen EndTime parametresi geçersiz.

400

Abs.Abs.InvalidSpotInstanceUID

%s

Öncelikli ödemeli örnek kimliğinin biçimi geçersiz.

400

InvalidParams.NetworkType

%s

Geçersiz NetworkType değeri.

400

InvalidParams.IoOptimized

%s

Geçersiz IoOptimized değeri.

400

InvalidParams.OSType

%s

Belirtilen OSType parametresi geçersiz.

400

Abs.IoOptimized.ValueNotSupported

%s

Örneğin G/Ç optimizasyon niteliği geçersiz. Belirtilen IoOptimized değerinin geçerli olup olmadığını kontrol edin.

400

InvalidZoneId.NotFound

Belirtilen alan mevcut değil.

Geçersiz ZoneId değeri.

400

InvalidParams.ZoneId

%s

Geçersiz ZoneId değeri.

400

InvalidParams.RegionId

%s

Geçersiz RegionId değeri.

400

InvalidParams.InstanceType

%s

Geçersiz InstanceType değeri.

400

InvalidParams.PageSize

%s

Geçersiz PageSize değeri.

400

InvalidParams.Offset

%s

Geçersiz Offset değeri.

400

InvalidInstanceType.ValueNotSupported

%s

Örnek türü bu işlemi desteklemiyor.

400

DependencyViolation.IoOptimized

Belirtilen instancetype, IoOptimized örneği olmalıdır.

Belirtilen örnek türü G/Ç optimize edilmiş olmalıdır.

400

InvalidSpotDuration

Belirtilen SpotDuration geçerli değil.

Geçersiz SpotDuration değeri.

403

InvalidUserType.NotSupported

%s

Hesap bu işlemi desteklemiyor.

403

Abs.InvalidAccount.NotFound

%s

Alibaba Cloud hesabınız mevcut değil veya AccessKey çiftinizin süresi dolmuş.

403

Forbedden.NotSupportRAM

%s

Resource Access Management (RAM) kullanıcılarının bu işlemi gerçekleştirme izni yok.

403

Forbbiden.SubUser

%s

Kaynağa erişim izniniz yok. Gerekli izinler için başvurmak üzere Alibaba Cloud hesabının sahibiyle iletişime geçin.

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