View a markdown version of this page

QueryForecast - Amazon Forecast
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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, difilter berdasarkan kriteria yang disediakan.

Kriteria adalah pasangan kunci-nilai. Kuncinya adalah item_id (atau bidang non-stempel waktu yang setara, non-target) dari TARGET_TIME_SERIES dataset, 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 CreateForecastExportJob operasi.

catatan

Prakiraan yang dihasilkan oleh Amazon Forecast berada di zona waktu yang sama dengan dataset 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 ramalan. Tentukan tanggal menggunakan format ini: yyyy- MM-dd 'T' HH:mm:ss (format ISO 8601). Misalnya, 2015-01-01T20:00:00.

Tipe: String

Wajib: Tidak

Filters

Kriteria pemfilteran yang akan diterapkan saat mengambil perkiraan. Misalnya, untuk mendapatkan perkiraan client_21 dalam kumpulan data penggunaan listrik, tentukan hal berikut:

{"item_id" : "client_21"}

Untuk mendapatkan perkiraan lengkap, gunakan CreateForecastExportJob operasi.

Tipe: Peta string ke string

Entri Peta: Jumlah maksimum 50 item.

Batasan Panjang Kunci: Panjang maksimum 256.

Pola Kunci: ^[a-zA-Z0-9\_\-]+$

Batasan Panjang Nilai: Panjang maksimum 256.

Wajib: Ya

ForecastArn

Nama Sumber Daya Amazon (ARN) dari perkiraan untuk ditanyakan.

Tipe: String

Batasan Panjang: Panjang maksimum 256.

Pola: arn:([a-z\d-]+):forecast:.*:.*:.+

Wajib: Ya

NextToken

Jika hasil permintaan sebelumnya terpotong, tanggapan termasuk a. NextToken Untuk mengambil set hasil berikutnya, gunakan token di permintaan berikutnya. Token kedaluwarsa setelah 24 jam.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 3000.

Wajib: Tidak

StartDate

Tanggal mulai untuk ramalan. Tentukan tanggal menggunakan format ini: yyyy- MM-dd 'T' HH:mm:ss (format ISO 8601). Misalnya, 2015-01-01T08: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.

Forecast

Prakiraan.

Tipe: Objek Forecast

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 telah Anda berikan dan coba lagi.

Kode Status HTTP: 400

Lihat Juga

Untuk informasi selengkapnya tentang menggunakan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini: