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.

# CreateWhatIfForecastExport
<a name="API_CreateWhatIfForecastExport"></a>

Exporte une prévision créée par l'[CreateWhatIfForecast](API_CreateWhatIfForecast.md)opération vers votre bucket Amazon Simple Storage Service (Amazon S3). Le nom du fichier de prévisions respectera les conventions suivantes :

 `≈<ForecastExportJobName>_<ExportTimestamp>_<PartNumber>` 

Le composant < ExportTimestamp > est en Java SimpleDateFormat (YYYY-MM-DDTHH-MM-SSZ).

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

Vous devez spécifier un [DataDestination](API_DataDestination.md) objet qui inclut un rôle Gestion des identités et des accès AWS (IAM) qu'Amazon Forecast peut assumer pour accéder au compartiment Amazon S3. Pour de plus amples informations, veuillez consulter [Configuration d'autorisations pour Amazon Forecast](aws-forecast-iam-roles.md).

Pour de plus amples informations, veuillez consulter [Génération de prévisions](howitworks-forecast.md).

Pour obtenir une liste de toutes vos tâches d'exportation de prévisions hypothétiques, utilisez l'[ListWhatIfForecastExports](API_ListWhatIfForecastExports.md)opération.

**Note**  
La tâche `Status` d'exportation des prévisions doit avoir lieu `ACTIVE` avant que vous puissiez accéder aux prévisions dans votre compartiment Amazon S3. Pour obtenir le statut, utilisez l'[DescribeWhatIfForecastExport](API_DescribeWhatIfForecastExport.md)opération.

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

```
{
   "Destination": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "Format": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "WhatIfForecastArns": [ "string" ],
   "WhatIfForecastExportName": "string"
}
```

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

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

 ** [Destination](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-Destination"></a>
L'emplacement où vous souhaitez enregistrer les prévisions et le rôle Gestion des identités et des accès AWS (IAM) qu'Amazon Forecast peut assumer pour accéder à l'emplacement. Les prévisions doivent être exportées vers un compartiment Amazon S3.  
Si le chiffrement est utilisé, `Destination` il doit inclure une clé AWS Key Management Service (KMS). Le rôle IAM doit autoriser Amazon Forecast à accéder à la clé.  
Type : objet [DataDestination](API_DataDestination.md)  
Obligatoire : oui

 ** [Format](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-Format"></a>
Le format des données exportées, CSV ou PARQUET.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 7.  
Modèle : `^CSV|PARQUET$`   
Obligatoire : non

 ** [Tags](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-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

 ** [WhatIfForecastArns](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-WhatIfForecastArns"></a>
La liste des prévisions hypothétiques Amazon Resource Names (ARNs) à exporter.  
Type : tableau de chaînes  
Membres du tableau : Nombre minimum de 1 élément. Nombre maximal de 50 éléments.  
Contraintes de longueur : longueur maximale de 300.  
Modèle : `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obligatoire : oui

 ** [WhatIfForecastExportName](#API_CreateWhatIfForecastExport_RequestSyntax) **   <a name="forecast-CreateWhatIfForecastExport-request-WhatIfForecastExportName"></a>
Nom de la prévision hypothétique à exporter.  
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_CreateWhatIfForecastExport_ResponseSyntax"></a>

```
{
   "WhatIfForecastExportArn": "string"
}
```

## Eléments de réponse
<a name="API_CreateWhatIfForecastExport_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.

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