Amazon Forecast は新規顧客には利用できなくなりました。Amazon Forecast の既存のお客様は、通常どおりサービスを引き続き使用できます。[詳細はこちら](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

What-If 分析は、時系列に仮定の変更を加え、その変化によって生成された予想を、ベースラインの未変更時系列と比較するシナリオモデリング手法です。What-If 分析の目的は、ベースラインの時系列にさまざまな変更が加えられた場合に、予想がどのように変化するかを理解することであることを覚えておいてください。

**重要**  
Amazon Forecast は新規顧客には利用できなくなりました。Amazon Forecast の既存のお客様は、通常どおりサービスを引き続き使用できます。[詳細はこちら](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

例えば、ある衣料品小売業者が、新しいスタイル用にスペースを空けるためにシーズン終了時のセールを検討していると想像してみてください。ベースライン予想を作成したら、What-If 分析を使用して、さまざまな販売戦略が目標にどのように影響するかを調査できます。

すべてに 25% の値下げを付与するシナリオと、すべてに固定ドルの値下げを付与するシナリオを作成できます。セールが 1 週間続くシナリオと、セールが 1 か月続くシナリオを作成できます。What-if 分析では、さまざまなシナリオを互いに比較できます。

What-If 分析は、予想モデルが学習した内容と、評価中のシナリオで予想モデルがどのように動作するかを表示するためのものであることに注意してください。What-If 分析の結果をやみくもにビジネス上の意思決定に使用しないでください。例えば、予想が適切かどうかを判断するための参考資料がないような新しいシナリオでは、予想が正確でない可能性があります。

[TimeSeriesSelector](API_TimeSeriesSelector.md) オブジェクトは what-if 分析に必要な項目を定義します。

**注記**  
What-If 分析を作成するには、データをカンマ区切り値 (CSV) 形式にする必要があります。

## リクエストの構文
<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"
}
```

## リクエストパラメーター
<a name="API_CreateWhatIfAnalysis_RequestParameters"></a>

リクエストは以下のデータを JSON 形式で受け入れます。

 ** [ForecastArn](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-ForecastArn"></a>
ベースライン予想の Amazon リソースネーム (ARN)。  
タイプ: 文字列  
長さの制約: 最大長は 256 です。  
パターン: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
必須: はい

 ** [Tags](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-Tags"></a>
What-If 予想に適用する[タグ](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html)のリスト。  
型: [Tag](API_Tag.md) オブジェクトの配列  
配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。  
必須: いいえ

 ** [TimeSeriesSelector](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-TimeSeriesSelector"></a>
`TimeSeriesIdentifiers` オブジェクトの What-If 分析で使用される時系列のセットを定義します。What-If 分析は、このオブジェクトの時系列に対してのみ実行されます。  
`TimeSeriesIdentifiers` オブジェクトには次の情報が必要です。  
+  `DataSource` 
+  `Format` 
+  `Schema` 
型: [TimeSeriesSelector](API_TimeSeriesSelector.md) オブジェクト  
必須: いいえ

 ** [WhatIfAnalysisName](#API_CreateWhatIfAnalysis_RequestSyntax) **   <a name="forecast-CreateWhatIfAnalysis-request-WhatIfAnalysisName"></a>
What-If 分析の名前。それぞれの名前は一意である必要があります。  
タイプ: 文字列  
長さの制約: 最小長は 1 です。最大長は 63 です。  
パターン: `^[a-zA-Z][a-zA-Z0-9_]*`   
必須: はい

## レスポンスの構文
<a name="API_CreateWhatIfAnalysis_ResponseSyntax"></a>

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

## レスポンス要素
<a name="API_CreateWhatIfAnalysis_ResponseElements"></a>

アクションが成功すると、サービスは HTTP 200 レスポンスを返します。

サービスから以下のデータが JSON 形式で返されます。

 ** [WhatIfAnalysisArn](#API_CreateWhatIfAnalysis_ResponseSyntax) **   <a name="forecast-CreateWhatIfAnalysis-response-WhatIfAnalysisArn"></a>
What-If 分析の Amazon リソースネーム (ARN)。  
タイプ: 文字列  
長さの制約: 最大長は 256 です。  
パターン: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## エラー
<a name="API_CreateWhatIfAnalysis_Errors"></a>

 ** InvalidInputException **   
無効な値または有効な範囲を超える値が含まれているため、リクエストを処理できません。  
HTTP ステータスコード: 400

 ** LimitExceededException **   
アカウントあたりのリソース数の制限を超えました。  
HTTP ステータスコード: 400

 ** ResourceAlreadyExistsException **   
この名前のリソースは既に存在します。別の名前で再試行してください。  
HTTP ステータスコード: 400

 ** ResourceInUseException **   
指定されたリソースは使用中です。  
HTTP ステータスコード: 400

 ** ResourceNotFoundException **   
その Amazon リソースネーム (ARN) を持つリソースが見つかりません。ARN を確認して、もう一度お試しください。  
HTTP ステータスコード: 400

## 以下の資料も参照してください。
<a name="API_CreateWhatIfAnalysis_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateWhatIfAnalysis) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateWhatIfAnalysis)