DescribeSpotPriceHistory - - Alibaba Cloud Documentation Center

Kueri riwayat harga instance preemptible dalam 30 hari terakhir.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan 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	Type	Required	Example	Description
Action	String	Yes	DescribeSpotPriceHistory	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeSpotPriceHistory.
RegionId	String	Yes	cn-hangzhou	ID wilayah instans. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.
ZoneId	String	No	cn-hangzhou-g	ID zona instans.
NetworkType	String	Yes	vpc	Jenis jaringan instans preemptible. Nilai yang valid: classic vpc
InstanceType	String	Yes	ecs.t1.xsmall	Tipe instans instans tersebut.
SpotDuration	Integer	No	1	Periode perlindungan instans preemptible. Satuan: jam. Nilai default: 1. Nilai yang valid: 1: Setelah instans preemptible dibuat, Alibaba Cloud menjamin bahwa instans tidak akan dilepas secara otomatis dalam waktu 1 jam. Setelah periode perlindungan 1 jam berakhir, sistem membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris resource untuk menentukan apakah instans dipertahankan atau dilepas. 0: Setelah instans preemptible dibuat, Alibaba Cloud tidak menjamin bahwa instans berjalan selama 1 jam. Sistem membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris resource untuk menentukan apakah instans dipertahankan atau dilepas. Alibaba Cloud mengirim peristiwa sistem Elastic Compute Service (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.
IoOptimized	String	No	optimized	Menentukan apakah instans dioptimalkan I/O. Nilai yang valid: optimized: Instans dioptimalkan I/O. none: Instans tidak dioptimalkan I/O. Untuk keluarga instans generasi I, nilai default-nya adalah none. Untuk keluarga instans lainnya, nilai default-nya adalah optimized.
StartTime	String	No	2017-08-22T08:45:08Z	Awal rentang waktu untuk dikueri. Tentukan waktu dalam standar ISO 8601 dengan format `yyyy-MM-ddTHH:mm:ssZ`. Waktu harus dalam UTC. Secara default, parameter ini kosong. Hal ini berarti waktu yang digunakan adalah 3 jam sebelum waktu yang ditentukan oleh EndTime.
EndTime	String	No	2017-08-22T08:45:08Z	Waktu akhir kueri. Tentukan waktu dalam standar ISO 8601 dengan format `yyyy-MM-ddTHH:mm:ssZ`. Waktu harus dalam UTC. Secara default, parameter ini kosong. Hal ini berarti waktu saat ini yang digunakan.
OSType	String	No	linux	Jenis platform sistem operasi. Nilai yang valid: linux windows
Offset	Integer	No	0	Baris tempat kueri dimulai. Nilai default: 0.

Parameter Respons

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID permintaan.
Currency	String	CNY	Unit mata uang harga. Situs Alibaba Cloud China (aliyun.com): CNY Situs Internasional Alibaba Cloud (alibabacloud.com): USD.
NextOffset	Integer	1000	Baris awal halaman berikutnya. Ini adalah nilai dari `Offset`.
SpotPrices	Array of SpotPriceType		Detail harga spot.
SpotPriceType
IoOptimized	String	optimized	Menunjukkan apakah instans preemptible dioptimalkan I/O.
ZoneId	String	cn-hangzhou-c	ID zona instans preemptible.
SpotPrice	Float	0.036	Harga spot instans preemptible.
Timestamp	String	2019-11-19T06:00:00Z	Waktu yang sesuai dengan harga spot yang dikueri. Waktu mengikuti standar ISO 8601 dalam format `YYYY-MM-DDThh:mm:ss`. Waktu ditampilkan dalam UTC.
NetworkType	String	vpc	Jenis jaringan instans preemptible.
InstanceType	String	ecs.g5.large	Tipe instans instans preemptible.
OriginPrice	Float	0.354	Harga untuk instans pay-as-you-go yang memiliki konfigurasi sama dengan instans preemptible yang ditentukan.

Contoh

Contoh permintaan

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

Contoh respons sukses

XML format

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 format

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

Kode Kesalahan

HttpCode	Error code	Error message	Description
400	MissingParameter	%s	Parameter yang diperlukan tidak ditentukan.
400	UnsupportedParameter	%s	Parameter yang ditentukan tidak didukung.
400	InvalidParameter	%s	Nilai parameter tidak valid.
400	InvalidInstanceID.Malformed	%s	Format InstanceId tidak valid.
400	InvalidParams.StartTime	%s	Nilai StartTime tidak valid.
400	InvalidParams.EndTime	%s	Parameter EndTime yang ditentukan tidak valid.
400	Abs.Abs.InvalidSpotInstanceUID	%s	Format ID instans preemptible tidak valid.
400	InvalidParams.NetworkType	%s	Nilai NetworkType tidak valid.
400	InvalidParams.IoOptimized	%s	Nilai IoOptimized tidak valid.
400	InvalidParams.OSType	%s	Parameter OSType yang ditentukan tidak valid.
400	Abs.IoOptimized.ValueNotSupported	%s	Atribut optimasi I/O instans tidak valid. Periksa apakah nilai IoOptimized yang ditentukan valid.
400	InvalidZoneId.NotFound	The specified zone does not exist.	Nilai ZoneId tidak valid.
400	InvalidParams.ZoneId	%s	Nilai ZoneId tidak valid.
400	InvalidParams.RegionId	%s	Nilai RegionId tidak valid.
400	InvalidParams.InstanceType	%s	Nilai InstanceType tidak valid.
400	InvalidParams.PageSize	%s	Nilai PageSize tidak valid.
400	InvalidParams.Offset	%s	Nilai Offset tidak valid.
400	InvalidInstanceType.ValueNotSupported	%s	Tipe instans tidak mendukung operasi ini.
400	DependencyViolation.IoOptimized	The specified instancetype must be IoOptimized instance.	Tipe instans yang ditentukan harus merupakan instans yang dioptimalkan I/O.
400	InvalidSpotDuration	The specified SpotDuration is not valid.	Nilai SpotDuration tidak valid.
403	InvalidUserType.NotSupported	%s	Akun tidak mendukung operasi ini.
403	Abs.InvalidAccount.NotFound	%s	Akun Alibaba Cloud Anda tidak ada, atau Pasangan Kunci Akses Anda telah kedaluwarsa.
403	Forbedden.NotSupportRAM	%s	Pengguna Manajemen Akses Sumber Daya (RAM) tidak memiliki izin untuk melakukan operasi ini.
403	Forbbiden.SubUser	%s	Anda tidak memiliki izin untuk mengakses resource tersebut. Hubungi pemilik Akun Alibaba Cloud untuk mengajukan izin yang diperlukan.

Untuk daftar kode kesalahan, lihat Kode Kesalahan Layanan.