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. # CreateForecast Membuat perkiraan untuk setiap item dalam `TARGET_TIME_SERIES` dataset yang digunakan untuk melatih prediktor. Ini dikenal sebagai inferensi. Untuk mengambil perkiraan untuk satu item pada latensi rendah, gunakan [QueryForecast](API_forecastquery_QueryForecast.md) operasi. Untuk mengekspor perkiraan lengkap ke bucket Amazon Simple Storage Service (Amazon S3) Anda, gunakan [CreateForecastExportJob](API_CreateForecastExportJob.md) operasi. **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/) Kisaran perkiraan ditentukan oleh `ForecastHorizon` nilai, yang Anda tentukan dalam [CreatePredictor](API_CreatePredictor.md) permintaan. Saat menanyakan perkiraan, Anda dapat meminta rentang tanggal tertentu dalam perkiraan. Untuk mendapatkan daftar semua perkiraan Anda, gunakan [ListForecasts](API_ListForecasts.md) operasi. **catatan** Prakiraan yang dihasilkan oleh Amazon Forecast berada di zona waktu yang sama dengan dataset yang digunakan untuk membuat prediktor. Untuk informasi selengkapnya, lihat [Menghasilkan Prakiraan](howitworks-forecast.md). **catatan** Prak `Status` iraan harus `ACTIVE` sebelum Anda dapat menanyakan atau mengekspor perkiraan. Gunakan [DescribeForecast](API_DescribeForecast.md) operasi untuk mendapatkan status. Secara default, perkiraan menyertakan prediksi untuk setiap item (`item_id`) dalam grup dataset yang digunakan untuk melatih prediktor. Namun, Anda dapat menggunakan `TimeSeriesSelector` objek untuk menghasilkan perkiraan pada subset deret waktu. Pembuatan perkiraan dilewati untuk setiap deret waktu yang Anda tentukan yang tidak ada dalam kumpulan data input. File ekspor perkiraan tidak akan berisi deret waktu ini atau nilai perkiraan mereka. ## Sintaksis Permintaan ``` { "ForecastName": "{{string}}", "ForecastTypes": [ "{{string}}" ], "PredictorArn": "{{string}}", "Tags": [ { "Key": "{{string}}", "Value": "{{string}}" } ], "TimeSeriesSelector": { "TimeSeriesIdentifiers": { "DataSource": { "S3Config": { "KMSKeyArn": "{{string}}", "Path": "{{string}}", "RoleArn": "{{string}}" } }, "Format": "{{string}}", "Schema": { "Attributes": [ { "AttributeName": "{{string}}", "AttributeType": "{{string}}" } ] } } } } ``` ## Parameter Permintaan Permintaan menerima data berikut dalam format JSON. ** [ForecastName](#API_CreateForecast_RequestSyntax) ** Sebuah nama untuk ramalan. Tipe: String Batasan Panjang: Panjang minimum 1. Panjang maksimum 63. Pola: `^[a-zA-Z][a-zA-Z0-9_]*` Wajib: Ya ** [ForecastTypes](#API_CreateForecast_RequestSyntax) ** Kuantil di mana perkiraan probabilistik dihasilkan. **Saat ini Anda dapat menentukan hingga 5 kuantil per perkiraan**. Nilai yang diterima meliputi `0.01 to 0.99` (hanya kenaikan 0,01) dan. `mean` Perkiraan rata-rata berbeda dari median (0,50) ketika distribusi tidak simetris (misalnya, Beta dan Binomial Negatif). Kuantil default adalah kuantil yang Anda tentukan selama pembuatan prediktor. Jika Anda tidak menentukan kuantil, nilai defaultnya adalah`["0.1", "0.5", "0.9"]`. Tipe: Array string Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 20 item. Batasan Panjang: Panjang minimum 2. Panjang maksimum 4. Pola: `(^0?\.\d\d?$|^mean$)` Wajib: Tidak ** [PredictorArn](#API_CreateForecast_RequestSyntax) ** Nama Sumber Daya Amazon (ARN) dari prediktor yang akan digunakan untuk menghasilkan perkiraan. Tipe: String Batasan Panjang: Panjang maksimum 256. Pola: `arn:([a-z\d-]+):forecast:.*:.*:.+` Wajib: Ya ** [Tags](#API_CreateForecast_RequestSyntax) ** Metadata opsional yang Anda terapkan ke prakiraan untuk membantu Anda mengkategorikan dan mengaturnya. Setiap tag terdiri dari satu kunci dan satu nilai opsional, yang keduanya Anda tentukan sendiri. Batasan dasar berikut berlaku untuk tanda: + Jumlah maksimum tag per sumber daya - 50. + Untuk setiap sumber daya, setiap kunci tanda harus unik, dan setiap kunci tanda hanya dapat memuat satu nilai. + Panjang kunci maksimum - 128 karakter Unicode dalam UTF-8. + Panjang nilai maksimum - 256 karakter Unicode dalam UTF-8. + Jika skema pemberian tag Anda digunakan di beberapa layanan dan sumber daya , ingatlah bahwa layanan lain mungkin memiliki pembatasan pada karakter yang diizinkan. Karakter yang umumnya diizinkan adalah: huruf, angka, dan spasi yang dapat direpresent UTF-8 asikan dalam, dan karakter berikut: \+ - =. \_:/@. + Kunci dan nilai tag peka huruf besar/kecil. + Jangan gunakan`aws:`,`AWS:`, atau kombinasi huruf besar atau kecil seperti awalan untuk kunci karena disediakan untuk AWS digunakan. Anda tidak dapat mengedit atau menghapus kunci tag dengan awalan ini. Nilai dapat memiliki awalan ini. Jika nilai tag memiliki awalan tetapi kuncinya tidak, maka Forecast menganggapnya `aws` sebagai tag pengguna dan akan dihitung terhadap batas 50 tag. Tag dengan hanya awalan kunci `aws` tidak dihitung terhadap tag Anda per batas sumber daya. Tipe: Array objek [Tag](API_Tag.md) Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item. Wajib: Tidak ** [TimeSeriesSelector](#API_CreateForecast_RequestSyntax) ** Mendefinisikan kumpulan deret waktu yang digunakan untuk membuat prakiraan dalam suatu `TimeSeriesIdentifiers` objek. Ob `TimeSeriesIdentifiers` jek membutuhkan informasi berikut: + `DataSource` + `Format` + `Schema` Tipe: Objek [TimeSeriesSelector](API_TimeSeriesSelector.md) Wajib: Tidak ## Sintaksis Respons ``` { "ForecastArn": "string" } ``` ## Elemen Respons Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200. Layanan mengembalikan data berikut dalam format JSON. ** [ForecastArn](#API_CreateForecast_ResponseSyntax) ** Nama Sumber Daya Amazon (ARN) dari perkiraan. Tipe: String Batasan Panjang: Panjang maksimum 256. Pola: `arn:([a-z\d-]+):forecast:.*:.*:.+` ## Kesalahan ** InvalidInputException ** Kami tidak dapat memproses permintaan karena menyertakan nilai yang tidak valid atau nilai yang melebihi rentang yang valid. Kode Status HTTP: 400 ** LimitExceededException ** Batas jumlah sumber daya per akun telah terlampaui. Kode Status HTTP: 400 ** ResourceAlreadyExistsException ** Sudah ada sumber daya dengan nama ini. Coba lagi dengan nama yang berbeda. Kode Status HTTP: 400 ** ResourceInUseException ** Sumber daya yang ditentukan sedang digunakan. Kode Status HTTP: 400 ** ResourceNotFoundException ** Kami tidak dapat menemukan sumber daya dengan Nama Sumber Daya Amazon (ARN) itu. Periksa ARN 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: + [AWS Antarmuka Baris Perintah V2 ](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateForecast) + [AWS SDK untuk.NET V4 ](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateForecast) + [AWS SDK untuk C\+\+ ](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateForecast) + [AWS SDK untuk Go v2 ](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateForecast) + [AWS SDK untuk Java V2 ](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateForecast) + [AWS SDK untuk JavaScript V3 ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateForecast) + [AWS SDK para Kotlin ](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateForecast) + [AWS SDK para PHP V3 ](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateForecast) + [AWS SDK untuk Python (Boto3) ](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateForecast) + [AWS SDK para Ruby V3 ](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateForecast)