Amazon Forecast tidak lagi tersedia untuk pelanggan baru. Pelanggan Amazon Forecast yang ada dapat terus menggunakan layanan seperti biasa. [Pelajari lebih lanjut”](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# QueryForecast
<a name="API_forecastquery_QueryForecast"></a>

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 [CreateForecastExportJob](https://docs.aws.amazon.com/en_us/forecast/latest/dg/API_CreateForecastExportJob.html)operasi.

**catatan**  
Prakiraan yang dihasilkan oleh Amazon Forecast berada dalam zona waktu yang sama dengan kumpulan data yang digunakan untuk membuat prediktor.

## Sintaksis Permintaan
<a name="API_forecastquery_QueryForecast_RequestSyntax"></a>

```
{
   "EndDate": "string",
   "Filters": { 
      "string" : "string" 
   },
   "ForecastArn": "string",
   "NextToken": "string",
   "StartDate": "string"
}
```

## Parameter Permintaan
<a name="API_forecastquery_QueryForecast_RequestParameters"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [EndDate](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-EndDate"></a>
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](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-Filters"></a>
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 [CreateForecastExportJob](https://docs.aws.amazon.com/en_us/forecast/latest/dg/API_CreateForecastExportJob.html)operasi.  
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](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-ForecastArn"></a>
Nama Sumber Daya Amazon (ARN) dari perkiraan yang akan ditanyakan.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Wajib: Ya

 ** [NextToken](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-NextToken"></a>
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.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 3000.  
Wajib: Tidak

 ** [StartDate](#API_forecastquery_QueryForecast_RequestSyntax) **   <a name="forecast-forecastquery_QueryForecast-request-StartDate"></a>
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
<a name="API_forecastquery_QueryForecast_ResponseSyntax"></a>

```
{
   "Forecast": { 
      "Predictions": { 
         "string" : [ 
            { 
               "Timestamp": "string",
               "Value": number
            }
         ]
      }
   }
}
```

## Elemen Respons
<a name="API_forecastquery_QueryForecast_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [Forecast](#API_forecastquery_QueryForecast_ResponseSyntax) **   <a name="forecast-forecastquery_QueryForecast-response-Forecast"></a>
Perkiraan.  
Tipe: Objek [Forecast](API_forecastquery_Forecast.md)

## Kesalahan
<a name="API_forecastquery_QueryForecast_Errors"></a>

 ** 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
<a name="API_forecastquery_QueryForecast_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/forecastquery-2018-06-26/QueryForecast) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecastquery-2018-06-26/QueryForecast)