Amazon Forecast tidak lagi tersedia untuk pelanggan baru. Pelanggan Amazon Forecast yang ada dapat terus menggunakan layanan seperti biasa. Pelajari lebih lanjut”
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
QueryForecast
Mengambil perkiraan untuk satu item, disaring berdasarkan kriteria yang disediakan.
Kriteria adalah pasangan kunci-nilai. Kuncinya adalah item_id
(atau bidang non-timestamp, non-target yang setara) dari TARGET_TIME_SERIES
kumpulan data, atau salah satu dimensi perkiraan yang ditentukan sebagai bagian dari objek. FeaturizationConfig
Secara default, QueryForecast
mengembalikan rentang tanggal lengkap untuk perkiraan yang difilter. Anda dapat meminta rentang tanggal tertentu.
Untuk mendapatkan perkiraan lengkap, gunakan CreateForecastExportJoboperasi.
catatan
Prakiraan yang dihasilkan oleh Amazon Forecast berada dalam zona waktu yang sama dengan kumpulan data yang digunakan untuk membuat prediktor.
Sintaksis Permintaan
{
"EndDate": "string
",
"Filters": {
"string
" : "string
"
},
"ForecastArn": "string
",
"NextToken": "string
",
"StartDate": "string
"
}
Parameter Permintaan
Permintaan menerima data berikut dalam format JSON.
- EndDate
-
Tanggal akhir untuk perkiraan. Tentukan tanggal menggunakan format ini: yyyy-mm-dd't'hh:mm: ss (format ISO 8601). Misalnya, 2015-01-01T 20:00:00.
Tipe: String
Wajib: Tidak
- Filters
-
Kriteria penyaringan untuk diterapkan saat mengambil perkiraan. Misalnya, untuk mendapatkan perkiraan
client_21
dalam dataset penggunaan listrik, tentukan yang berikut ini:{"item_id" : "client_21"}
Untuk mendapatkan perkiraan lengkap, gunakan CreateForecastExportJoboperasi.
Tipe: Peta string ke string
Entri Peta: Jumlah maksimum 50 item.
Kendala Panjang Kunci: Panjang maksimum 256.
Pola Kunci:
^[a-zA-Z0-9\_\-]+$
Kendala Panjang Nilai: Panjang maksimum 256.
Wajib: Ya
- ForecastArn
-
Nama Sumber Daya Amazon (ARN) dari perkiraan yang akan ditanyakan.
Jenis: String
Batasan Panjang: Panjang maksimum 256.
Pola:
arn:([a-z\d-]+):forecast:.*:.*:.+
Wajib: Ya
- NextToken
-
Jika hasil dari permintaan sebelumnya terpotong, responsnya mencakup a.
NextToken
Untuk mengambil set hasil berikutnya, gunakan token dalam permintaan berikutnya. Token kedaluwarsa setelah 24 jam.Jenis: String
Batasan Panjang: Panjang minimum 1. Panjang maksimum 3000.
Wajib: Tidak
- StartDate
-
Tanggal mulai untuk perkiraan. Tentukan tanggal menggunakan format ini: yyyy-mm-dd't'hh:mm: ss (format ISO 8601). Misalnya, 2015-01-01T 08:00:00.
Tipe: String
Wajib: Tidak
Sintaksis Respons
{
"Forecast": {
"Predictions": {
"string" : [
{
"Timestamp": "string",
"Value": number
}
]
}
}
}
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
Kesalahan
- InvalidInputException
-
Nilai tidak valid atau terlalu panjang.
Kode Status HTTP: 400
- InvalidNextTokenException
-
Token tidak valid. Token kedaluwarsa setelah 24 jam.
Kode Status HTTP: 400
- LimitExceededException
-
Batas jumlah permintaan per detik telah terlampaui.
Kode Status HTTP: 400
- ResourceInUseException
-
Sumber daya yang ditentukan sedang digunakan.
Kode Status HTTP: 400
- ResourceNotFoundException
-
Kami tidak dapat menemukan sumber daya itu. Periksa informasi yang Anda berikan dan coba lagi.
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: