QueryForecast - Amazon Forecast
Sintaksis PermintaanParameter PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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.

Forecast

Perkiraan.

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 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: