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.

# ListForecasts
<a name="API_ListForecasts"></a>

Mengembalikan daftar prakiraan yang dibuat menggunakan [CreateForecast](API_CreateForecast.md) operasi. Untuk setiap perkiraan, operasi ini mengembalikan ringkasan propertinya, termasuk Nama Sumber Daya Amazon (ARN). Untuk mengambil set lengkap properti, tentukan ARN dengan [DescribeForecast](API_DescribeForecast.md) operasi. Anda dapat memfilter daftar menggunakan array [Filter](API_Filter.md) objek.

**penting**  
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/) 

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

```
{
   "Filters": [ 
      { 
         "Condition": "{{string}}",
         "Key": "{{string}}",
         "Value": "{{string}}"
      }
   ],
   "MaxResults": {{number}},
   "NextToken": "{{string}}"
}
```

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

Permintaan menerima data berikut dalam format JSON.

 ** [Filters](#API_ListForecasts_RequestSyntax) **   <a name="forecast-ListForecasts-request-Filters"></a>
Array filter. Untuk setiap filter, Anda memberikan kondisi dan pernyataan kecocokan. Syaratnya adalah salah `IS` satu atau`IS_NOT`, yang menentukan apakah akan memasukkan atau mengecualikan perkiraan yang sesuai dengan pernyataan dari daftar, masing-masing. Pernyataan pertandingan terdiri dari kunci dan nilai.  
 **Sifat filter **   
+  `Condition`- Kondisi untuk melamar. Nilai yang valid adalah `IS` dan `IS_NOT`. Untuk memasukkan prakiraan yang cocok dengan pernyataan, tentukan`IS`. Untuk mengecualikan perkiraan yang cocok, tentukan`IS_NOT`.
+  `Key`- Nama parameter untuk difilter. Nilai yang valid adalah `DatasetGroupArn`, `PredictorArn`, dan `Status`.
+  `Value`- Nilai yang cocok.
Misalnya, untuk mencantumkan semua prakiraan yang statusnya tidak AKTIF, Anda akan menentukan:  
 `"Filters": [ { "Condition": "IS_NOT", "Key": "Status", "Value": "ACTIVE" } ]`   
Tipe: Array objek [Filter](API_Filter.md)  
Wajib: Tidak

 ** [MaxResults](#API_ListForecasts_RequestSyntax) **   <a name="forecast-ListForecasts-request-MaxResults"></a>
Jumlah item yang akan dikembalikan dalam tanggapan.  
Tipe: Bilangan Bulat  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 100.  
Wajib: Tidak

 ** [NextToken](#API_ListForecasts_RequestSyntax) **   <a name="forecast-ListForecasts-request-NextToken"></a>
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.  
Pola: `.+`   
Diperlukan: Tidak

## Sintaksis Respons
<a name="API_ListForecasts_ResponseSyntax"></a>

```
{
   "Forecasts": [ 
      { 
         "CreatedUsingAutoPredictor": boolean,
         "CreationTime": number,
         "DatasetGroupArn": "string",
         "ForecastArn": "string",
         "ForecastName": "string",
         "LastModificationTime": number,
         "Message": "string",
         "PredictorArn": "string",
         "Status": "string"
      }
   ],
   "NextToken": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [Forecasts](#API_ListForecasts_ResponseSyntax) **   <a name="forecast-ListForecasts-response-Forecasts"></a>
Array objek yang merangkum properti masing-masing perkiraan.  
Tipe: Array objek [ForecastSummary](API_ForecastSummary.md)

 ** [NextToken](#API_ListForecasts_ResponseSyntax) **   <a name="forecast-ListForecasts-response-NextToken"></a>
Jika respons terpotong, Amazon Forecast mengembalikan token ini. Untuk mengambil set hasil berikutnya, gunakan token di permintaan berikutnya.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 3000.  
Pola: `.+` 

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

 ** InvalidInputException **   
Kami tidak dapat memproses permintaan karena menyertakan nilai yang tidak valid atau nilai yang melebihi rentang yang valid.  
Kode Status HTTP: 400

 ** InvalidNextTokenException **   
Token tidak valid. Token kedaluwarsa setelah 24 jam.  
Kode Status HTTP: 400

## Lihat Juga
<a name="API_ListForecasts_SeeAlso"></a>

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