

 Amazon Forecast n'est plus disponible pour les nouveaux clients. Les clients existants d'Amazon Forecast peuvent continuer à utiliser le service normalement. [En savoir plus »](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# CreateWhatIfForecast
<a name="API_CreateWhatIfForecast"></a>

Une prévision hypothétique est une prévision créée à partir d'une version modifiée de la prévision de base. Chaque prévision hypothétique intègre soit un jeu de données de remplacement, soit un ensemble de transformations du jeu de données d'origine. 

**Important**  
Amazon Forecast n'est plus disponible pour les nouveaux clients. Les clients existants d'Amazon Forecast peuvent continuer à utiliser le service normalement. [En savoir plus »](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

## Syntaxe de la requête
<a name="API_CreateWhatIfForecast_RequestSyntax"></a>

```
{
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimeSeriesReplacementsDataSource": { 
      "Format": "string",
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      },
      "Schema": { 
         "Attributes": [ 
            { 
               "AttributeName": "string",
               "AttributeType": "string"
            }
         ]
      },
      "TimestampFormat": "string"
   },
   "TimeSeriesTransformations": [ 
      { 
         "Action": { 
            "AttributeName": "string",
            "Operation": "string",
            "Value": number
         },
         "TimeSeriesConditions": [ 
            { 
               "AttributeName": "string",
               "AttributeValue": "string",
               "Condition": "string"
            }
         ]
      }
   ],
   "WhatIfAnalysisArn": "string",
   "WhatIfForecastName": "string"
}
```

## Paramètres de demande
<a name="API_CreateWhatIfForecast_RequestParameters"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [Tags](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-Tags"></a>
Une liste de [balises](https://docs.aws.amazon.com/forecast/latest/dg/tagging-forecast-resources.html) à appliquer aux prévisions hypothétiques.  
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : non

 ** [TimeSeriesReplacementsDataSource](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-TimeSeriesReplacementsDataSource"></a>
Le jeu de données de série chronologique de remplacement, qui contient les lignes que vous souhaitez modifier dans le jeu de données de séries chronologiques associé. Il n'est pas nécessaire qu'une série chronologique de remplacement contienne toutes les lignes de la série chronologique associée à la référence. N'incluez que les lignes (combinaisons de mesures et de dimensions) que vous souhaitez inclure dans les prévisions hypothétiques.  
Ce jeu de données est fusionné avec la série chronologique d'origine pour créer un ensemble de données transformé qui est utilisé pour l'analyse hypothétique.  
Cet ensemble de données doit contenir les éléments à modifier (tels que item\$1id ou workforce\$1type), toutes les dimensions pertinentes, la colonne d'horodatage et au moins l'une des colonnes de séries chronologiques associées. Ce fichier ne doit pas contenir d'horodatages dupliqués pour la même série chronologique. Ce fichier doit être au format CSV.  
Les horodatages et les item\$1ids non inclus dans cet ensemble de données ne sont pas inclus dans l'analyse hypothétique.   
Type : objet [TimeSeriesReplacementsDataSource](API_TimeSeriesReplacementsDataSource.md)  
Obligatoire : non

 ** [TimeSeriesTransformations](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-TimeSeriesTransformations"></a>
Les transformations appliquées à la série chronologique de référence. Chaque transformation contient une action et un ensemble de conditions. Une action n'est appliquée que lorsque toutes les conditions sont remplies. Si aucune condition n'est spécifiée, l'action est appliquée à tous les éléments.  
Type : tableau d’objets [TimeSeriesTransformation](API_TimeSeriesTransformation.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 30 articles.  
Obligatoire : non

 ** [WhatIfAnalysisArn](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-WhatIfAnalysisArn"></a>
Le nom de ressource Amazon (ARN) de l'analyse hypothétique.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obligatoire : oui

 ** [WhatIfForecastName](#API_CreateWhatIfForecast_RequestSyntax) **   <a name="forecast-CreateWhatIfForecast-request-WhatIfForecastName"></a>
Le nom de la prévision hypothétique. Les noms doivent être uniques dans chaque analyse hypothétique.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63.  
Modèle : `^[a-zA-Z][a-zA-Z0-9_]*`   
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_CreateWhatIfForecast_ResponseSyntax"></a>

```
{
   "WhatIfForecastArn": "string"
}
```

## Eléments de réponse
<a name="API_CreateWhatIfForecast_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [WhatIfForecastArn](#API_CreateWhatIfForecast_ResponseSyntax) **   <a name="forecast-CreateWhatIfForecast-response-WhatIfForecastArn"></a>
Le nom de ressource Amazon (ARN) de la prévision hypothétique.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 300.  
Modèle : `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## Erreurs
<a name="API_CreateWhatIfForecast_Errors"></a>

 ** InvalidInputException **   
Nous ne pouvons pas traiter la demande car elle contient une valeur non valide ou une valeur qui dépasse la plage valide.  
Code d’état HTTP : 400

 ** LimitExceededException **   
La limite du nombre de ressources par compte a été dépassée.  
Code d’état HTTP : 400

 ** ResourceAlreadyExistsException **   
Il existe déjà une ressource portant ce nom. Réessayez avec un autre nom.  
Code d’état HTTP : 400

 ** ResourceInUseException **   
La ressource spécifiée est en cours d'utilisation.  
Code d’état HTTP : 400

 ** ResourceNotFoundException **   
Nous ne trouvons aucune ressource portant ce nom de ressource Amazon (ARN). Vérifiez l'ARN et réessayez.  
Code d’état HTTP : 400

## Voir aussi
<a name="API_CreateWhatIfForecast_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateWhatIfForecast) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateWhatIfForecast) 