DescribeSpotPriceHistory - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengkueri harga historis spot instans. Anda dapat mengkueri data harga dari 30 hari terakhir. Data harga historis membantu Anda menetapkan harga maksimum yang wajar untuk spot instans.

Deskripsi operasi

Hanya spot instans yang dioptimalkan I/O yang didukung.
Data yang dikembalikan oleh operasi ini mungkin terpaginasi. Jika tanggapan mengandung parameter NextOffset, atur parameter permintaan Offset ke nilai NextOffset untuk mengkueri halaman data berikutnya.

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 instans. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
RegionId	string	Yes	ID wilayah instans. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
ZoneId	string	No	ID zona.	cn-hangzhou-g
NetworkType	string	Yes	Jenis jaringan spot instans. Nilai valid: vpc: virtual private cloud (VPC). classic: jaringan klasik. Fitur ini telah dihentikan. Untuk informasi selengkapnya, lihat Pemberitahuan penghentian.	vpc
InstanceType	string	Yes	Tipe instans.	ecs.t1.xsmall
SpotDuration	integer	No	Periode perlindungan spot instans. Unit: jam. Nilai default: 1. Nilai valid: 1: Setelah spot instans dibuat, Alibaba Cloud memastikan bahwa instans tidak dilepaskan secara otomatis dalam 1 jam. Setelah 1 jam, sistem membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris resource untuk menentukan apakah akan mempertahankan atau melepaskan instans secara otomatis. 0: Setelah spot instans dibuat, Alibaba Cloud tidak memastikan bahwa instans berjalan selama 1 jam. Sistem membandingkan harga penawaran dengan harga pasar dan memeriksa inventaris resource untuk menentukan apakah akan mempertahankan atau melepaskan instans secara otomatis. Alibaba Cloud mengirimkan notifikasi peristiwa sistem ECS 5 menit sebelum instans dilepaskan. Spot instans ditagih per detik. Tentukan periode perlindungan yang sesuai berdasarkan durasi eksekusi tugas yang diharapkan. Catatan Parameter ini hanya berlaku jika SpotStrategy diatur ke SpotWithPriceLimit atau SpotAsPriceGo.	1
IoOptimized	string	No	Apakah spot instans dioptimalkan I/O. Nilai valid: optimized: Spot instans adalah instans yang dioptimalkan I/O. none: Spot instans bukan instans yang dioptimalkan I/O. Nilai default untuk keluarga instans Generasi I: none. Nilai default untuk keluarga instans lainnya: optimized.	optimized
StartTime	string	No	Awal pengatur waktu untuk mengkueri harga historis spot instans. Pengatur waktu maksimum antara waktu mulai dan waktu akhir adalah 30 hari. Tentukan waktu dalam standar ISO 8601 dengan format `yyyy-MM-ddTHH:mm:ssZ`. Waktu harus dalam UTC. Nilai default: null, yang menunjukkan 3 jam sebelum waktu akhir.	2017-08-22T08:45:08Z
EndTime	string	No	Akhir rentang waktu untuk mengkueri harga historis spot instans. Tentukan waktu dalam standar ISO 8601 dengan format `yyyy-MM-ddTHH:mm:ssZ`. Waktu harus dalam UTC. Nilai default: null, yang menunjukkan waktu saat ini.	2017-08-22T08:45:08Z
OSType	string	No	Tipe platform sistem operasi. Nilai valid: linux. windows.	linux
Offset	integer	No	Baris tempat kueri dimulai. Nilai default: 0.	0

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Currency	string	Unit mata uang harga. Situs Tiongkok: CNY. Situs internasional: USD.	CNY
NextOffset	integer	Baris awal halaman berikutnya. Atur parameter `Offset` ke nilai ini untuk mengkueri halaman data berikutnya.	1000
SpotPrices	object
SpotPriceType	array<object>	Detail harga spot.
	object
IoOptimized	string	Apakah instans preemptible adalah instans yang dioptimalkan I/O.	optimized
ZoneId	string	ID zona instans preemptible.	cn-hangzhou-c
SpotPrice	number	Harga instans preemptible.	0.036
Timestamp	string	Waktu harga dalam format `yyyy-MM-ddTHH:mm:ssZ`.	2019-11-19T06:00:00Z
NetworkType	string	Jenis jaringan instans preemptible.	vpc
InstanceType	string	Tipe instans preemptible.	ecs.g5.large
OriginPrice	number	Harga asli instans pay-as-you-go.	0.354

Contoh

Respons sukses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Currency": "CNY",
  "NextOffset": 1000,
  "SpotPrices": {
    "SpotPriceType": [
      {
        "IoOptimized": "optimized",
        "ZoneId": "cn-hangzhou-c",
        "SpotPrice": 0.036,
        "Timestamp": "2019-11-19T06:00:00Z",
        "NetworkType": "vpc",
        "InstanceType": "ecs.g5.large",
        "OriginPrice": 0.354
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message
400	MissingParameter	%s
400	UnsupportedParameter	%s
400	InvalidParameter	%s
400	InvalidInstanceID.Malformed	%s
400	InvalidParams.StartTime	%s
400	InvalidParams.EndTime	%s
400	Abs.Abs.InvalidSpotInstanceUID	%s
400	InvalidParams.NetworkType	%s
400	InvalidParams.IoOptimized	%s
400	InvalidParams.OSType	%s
400	Abs.IoOptimized.ValueNotSupported	%s
400	InvalidZoneId.NotFound	The specified zone does not exist.
400	InvalidParams.ZoneId	%s
400	InvalidParams.RegionId	%s
400	InvalidParams.InstanceType	%s
400	InvalidParams.PageSize	%s
400	InvalidParams.Offset	%s
400	InvalidInstanceType.ValueNotSupported	%s
400	DependencyViolation.IoOptimized	The specified instancetype must be IoOptimized instance.
400	InvalidSpotDuration	The specified SpotDuration is not valid.
400	OperationDenied.QueryFail	Query spot price fail, please retry later.
403	InvalidUserType.NotSupported	%s
403	Abs.InvalidAccount.NotFound	%s
403	Forbedden.NotSupportRAM	%s
403	Forbbiden.SubUser	%s
403	OperationDenied.RegionIdNotSupported	region not support spot duration instance.
403	OperationDenied.FlavorNotSupported	flavor not support spot duration instance.
403	OperationDenied.TimestampNotSupported	timestamp not support spot duration instance.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.