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.

# CreateWhatIfAnalysis
<a name="API_CreateWhatIfAnalysis"></a>

What-if analisis adalah teknik pemodelan skenario di mana Anda membuat perubahan hipotetis ke deret waktu dan membandingkan perkiraan yang dihasilkan oleh perubahan ini terhadap deret waktu dasar yang tidak berubah. Penting untuk diingat bahwa tujuan analisis apa-jika adalah untuk memahami bagaimana perkiraan dapat berubah mengingat modifikasi yang berbeda pada deret waktu dasar.

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

Misalnya, bayangkan Anda adalah pengecer pakaian yang sedang mempertimbangkan penjualan akhir musim untuk membersihkan ruang untuk gaya baru. Setelah membuat perkiraan dasar, Anda dapat menggunakan analisis bagaimana jika untuk menyelidiki bagaimana taktik penjualan yang berbeda dapat memengaruhi tujuan Anda.

Anda dapat membuat skenario di mana semuanya diberi penurunan harga 25%, dan skenario lain di mana semuanya diberi penurunan harga dolar tetap. Anda dapat membuat skenario di mana penjualan berlangsung selama satu minggu dan satu lagi di mana penjualan berlangsung selama satu bulan. Dengan analisis what-if, Anda dapat membandingkan banyak skenario berbeda satu sama lain.

Perhatikan bahwa analisis what-if dimaksudkan untuk menampilkan apa yang telah dipelajari model peramalan dan bagaimana perilakunya dalam skenario yang Anda evaluasi. Jangan secara membabi buta menggunakan hasil analisis what-if untuk membuat keputusan bisnis. Misalnya, perkiraan mungkin tidak akurat untuk skenario baru di mana tidak ada referensi yang tersedia untuk menentukan apakah ramalan itu baik.

Ob [TimeSeriesSelector](API_TimeSeriesSelector.md) jek mendefinisikan item yang Anda inginkan dalam analisis what-if.

**catatan**  
Data Anda harus dalam format nilai yang dipisahkan koma (CSV) untuk membuat analisis what-if.

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

```
{
   "ForecastArn": "{{string}}",
   "Tags": [ 
      { 
         "Key": "{{string}}",
         "Value": "{{string}}"
      }
   ],
   "TimeSeriesSelector": { 
      "TimeSeriesIdentifiers": { 
         "DataSource": { 
            "S3Config": { 
               "KMSKeyArn": "{{string}}",
               "Path": "{{string}}",
               "RoleArn": "{{string}}"
            }
         },
         "Format": "{{string}}",
         "Schema": { 
            "Attributes": [ 
               { 
                  "AttributeName": "{{string}}",
                  "AttributeType": "{{string}}"
               }
            ]
         }
      }
   },
   "WhatIfAnalysisName": "{{string}}"
}
```

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

Permintaan menerima data berikut dalam format JSON.

 ** [ForecastArn](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-ForecastArn"></a>
Nama Sumber Daya Amazon (ARN) dari perkiraan dasar.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Wajib: Ya

 ** [Tags](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-Tags"></a>
Daftar [ tag ](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html) untuk diterapkan pada perkiraan apa jika.  
Tipe: Array objek [Tag](API_Tag.md)  
Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 200 item.  
Wajib: Tidak

 ** [TimeSeriesSelector](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-TimeSeriesSelector"></a>
Mendefinisikan himpunan deret waktu yang digunakan dalam analisis what-if dengan sebuah `TimeSeriesIdentifiers` objek. What-if analisis dilakukan hanya untuk deret waktu dalam objek ini.  
Ob `TimeSeriesIdentifiers` jek membutuhkan informasi berikut:  
+  `DataSource` 
+  `Format` 
+  `Schema` 
Tipe: Objek [TimeSeriesSelector](API_TimeSeriesSelector.md)  
Wajib: Tidak

 ** [WhatIfAnalysisName](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-WhatIfAnalysisName"></a>
Nama analisis what-if. Setiap nama harus unik.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 63.  
Pola: `^[a-zA-Z][a-zA-Z0-9_]*`   
Diperlukan: Ya

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

```
{
   "WhatIfAnalysisArn": "string"
}
```

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

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [WhatIfAnalysisArn](#API_CreateWhatIfAnalysis_ResponseSyntax) **   <a name="forecast-CreateWhatIfAnalysis-response-WhatIfAnalysisArn"></a>
Nama Sumber Daya Amazon (ARN) dari analisis what-if.  
Tipe: String  
Batasan Panjang: Panjang maksimum 256.  
Pola: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## Kesalahan
<a name="API_CreateWhatIfAnalysis_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

 ** 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
<a name="API_CreateWhatIfAnalysis_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/CreateWhatIfAnalysis) 
+  [AWS SDK untuk.NET V4 ](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK untuk C\+\+ ](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK untuk Go v2 ](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK untuk Java V2 ](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK untuk JavaScript V3 ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK para Kotlin ](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK para PHP V3 ](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK untuk Python (Boto3) ](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK para Ruby V3 ](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateWhatIfAnalysis)