

 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.

# CreateForecastExportJob
<a name="API_CreateForecastExportJob"></a>

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

<ForecastExportJobName>\$1<ExportTimestamp>\$1<PartNumber>

où 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, utilisez l'[ListForecastExportJobs](API_ListForecastExportJobs.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'[DescribeForecastExportJob](API_DescribeForecastExportJob.md)opération.

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

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

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

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

 ** [Destination](#API_CreateForecastExportJob_RequestSyntax) **   <a name="forecast-CreateForecastExportJob-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

 ** [ForecastArn](#API_CreateForecastExportJob_RequestSyntax) **   <a name="forecast-CreateForecastExportJob-request-ForecastArn"></a>
Le nom de ressource Amazon (ARN) de la prévision que vous souhaitez exporter.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obligatoire : oui

 ** [ForecastExportJobName](#API_CreateForecastExportJob_RequestSyntax) **   <a name="forecast-CreateForecastExportJob-request-ForecastExportJobName"></a>
Nom de la tâche d'exportation des prévisions.  
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

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

 ** [Tags](#API_CreateForecastExportJob_RequestSyntax) **   <a name="forecast-CreateForecastExportJob-request-Tags"></a>
Les métadonnées facultatives que vous appliquez à la tâche d'exportation des prévisions pour vous aider à les classer et à les organiser. Chaque balise est constituée d’une clé et d’une valeur facultative que vous définissez.  
Les restrictions de base suivantes s’appliquent aux balises :  
+ Nombre maximum de balises par ressource : 50.
+ Pour chaque ressource, chaque clé d'identification doit être unique, et chaque clé d'identification peut avoir une seule valeur.
+ Longueur de clé maximale : 128 caractères Unicode en UTF-8.
+ Longueur maximale de la valeur : 256 caractères Unicode en UTF-8.
+ Si votre schéma d'identification est utilisé pour plusieurs services et ressources, n'oubliez pas que d'autres services peuvent avoir des restrictions concernant les caractères autorisés. Les caractères généralement autorisés sont les lettres, les chiffres et les espaces représentables en UTF-8, ainsi que les caractères suivants : \$1 - =. \$1 :/@.
+ Les clés et les valeurs des balises distinguent les majuscules et minuscules.
+ N'utilisez pas `aws:``AWS:`, ni aucune combinaison majuscules ou minuscules, comme un préfixe pour les clés, car il est réservé à l'usage. AWS Vous ne pouvez pas modifier ou supprimer les clés de balise avec ce préfixe. Les valeurs peuvent avoir ce préfixe. Si une valeur de balise a `aws` pour préfixe, mais pas la clé, Forecast considère qu'il s'agit d'une balise utilisateur et compte dans la limite de 50 balises. Les balises dont le seul préfixe est « ne sont pas prises en compte dans `aws` le calcul de vos balises par limite de ressources ».
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

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

```
{
   "ForecastExportJobArn": "string"
}
```

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

 ** [ForecastExportJobArn](#API_CreateForecastExportJob_ResponseSyntax) **   <a name="forecast-CreateForecastExportJob-response-ForecastExportJobArn"></a>
Le nom de ressource Amazon (ARN) de la tâche d'exportation.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):forecast:.*:.*:.+` 

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