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. # CreateForecast Crée une prévision pour chaque élément de l'`TARGET_TIME_SERIES`ensemble de données qui a été utilisé pour entraîner le prédicteur. C'est ce que l'on appelle l'inférence. Pour récupérer la prévision pour un seul élément à faible latence, utilisez l'[QueryForecast](API_forecastquery_QueryForecast.md)opération. Pour exporter la prévision complète vers votre compartiment Amazon Simple Storage Service (Amazon S3), utilisez l'[CreateForecastExportJob](API_CreateForecastExportJob.md)opération. **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/) La plage de la prévision est déterminée par la `ForecastHorizon` valeur que vous spécifiez dans la [CreatePredictor](API_CreatePredictor.md) demande. Lorsque vous interrogez une prévision, vous pouvez demander une plage de dates spécifique au sein de la prévision. Pour obtenir la liste de toutes vos prévisions, utilisez l'[ListForecasts](API_ListForecasts.md)opération. **Note** Les prévisions générées par Amazon Forecast se situent dans le même fuseau horaire que le jeu de données utilisé pour créer le prédicteur. Pour de plus amples informations, veuillez consulter [Génération de prévisions](howitworks-forecast.md). **Note** Vous devez avoir obtenu la valeur `Status` de la prévision `ACTIVE` avant de pouvoir l'interroger ou l'exporter. Utilisez l'opération [DescribeForecast](API_DescribeForecast.md) pour obtenir le statut. Par défaut, une prévision inclut des prédictions pour chaque élément (`item_id`) du groupe de données qui a été utilisé pour entraîner le prédicteur. Vous pouvez toutefois utiliser l'`TimeSeriesSelector`objet pour générer une prévision sur un sous-ensemble de séries chronologiques. La création de prévisions est ignorée pour toutes les séries chronologiques que vous spécifiez et qui ne figurent pas dans le jeu de données en entrée. Le fichier d'exportation des prévisions ne contiendra pas ces séries chronologiques ni leurs valeurs prévisionnelles. ## Syntaxe de la requête ``` { "ForecastName": "{{string}}", "ForecastTypes": [ "{{string}}" ], "PredictorArn": "{{string}}", "Tags": [ { "Key": "{{string}}", "Value": "{{string}}" } ], "TimeSeriesSelector": { "TimeSeriesIdentifiers": { "DataSource": { "S3Config": { "KMSKeyArn": "{{string}}", "Path": "{{string}}", "RoleArn": "{{string}}" } }, "Format": "{{string}}", "Schema": { "Attributes": [ { "AttributeName": "{{string}}", "AttributeType": "{{string}}" } ] } } } } ``` ## Paramètres de demande Cette demande accepte les données suivantes au format JSON. ** [ForecastName](#API_CreateForecast_RequestSyntax) ** Nom de la prévision. 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 ** [ForecastTypes](#API_CreateForecast_RequestSyntax) ** Quantiles auxquels les prévisions probabilistes sont générées. **Vous pouvez actuellement spécifier jusqu'à 5 quantiles par prévision**. Les valeurs acceptées incluent `0.01 to 0.99` (incréments de 0,01 uniquement) et. `mean` La prévision moyenne est différente de la médiane (0,50) lorsque la distribution n'est pas symétrique (par exemple, binomiale bêta et négative). Les quantiles par défaut sont les quantiles que vous avez spécifiés lors de la création du prédicteur. Si vous n'avez pas spécifié de quantiles, les valeurs par défaut sont`["0.1", "0.5", "0.9"]`. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 20 éléments. Contraintes de longueur : longueur minimale de 2. Longueur maximale de 4. Modèle : `(^0?\.\d\d?$|^mean$)` Obligatoire : non ** [PredictorArn](#API_CreateForecast_RequestSyntax) ** Le nom de ressource Amazon (ARN) du prédicteur à utiliser pour générer la prévision. Type : Chaîne Contraintes de longueur : longueur maximale de 256. Modèle : `arn:([a-z\d-]+):forecast:.*:.*:.+` Obligatoire : oui ** [Tags](#API_CreateForecast_RequestSyntax) ** Les métadonnées facultatives que vous appliquez aux 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. UTF-8 + Longueur de valeur maximale : 256 caractères Unicode. UTF-8 + Si votre schéma de balisage 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 pouvant être représentés par UTF-8, et les caractères suivants : \+ - =. \_ :/@. + Les clés et les valeurs des balises font la distinction entre majuscules et minuscules. + N'utilisez pas `aws:``AWS:`, ou toute combinaison majuscule ou minuscule de ce type, comme préfixe pour les clés, car son utilisation est réservée. AWS Vous ne pouvez ni modifier ni supprimer les clés de tag 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 sera prise en compte dans la limite de 50 balises. Les balises dont le seul préfixe clé est ne sont `aws` pas prises en compte dans vos balises par limite de ressource. 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 ** [TimeSeriesSelector](#API_CreateForecast_RequestSyntax) ** Définit l'ensemble de séries chronologiques utilisées pour créer les prévisions dans un `TimeSeriesIdentifiers` objet. L'`TimeSeriesIdentifiers`objet a besoin des informations suivantes : + `DataSource` + `Format` + `Schema` Type : objet [TimeSeriesSelector](API_TimeSeriesSelector.md) Obligatoire : non ## Syntaxe de la réponse ``` { "ForecastArn": "string" } ``` ## Eléments de réponse 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. ** [ForecastArn](#API_CreateForecast_ResponseSyntax) ** Le nom de ressource Amazon (ARN) de la prévision. Type : Chaîne Contraintes de longueur : longueur maximale de 256. Modèle : `arn:([a-z\d-]+):forecast:.*:.*:.+` ## Erreurs ** 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 Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS kits SDK spécifiques à une langue, consultez les rubriques suivantes : + [AWS Interface de ligne de commande V2 ](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateForecast) + [AWS SDK pour .NET V4 ](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateForecast) + [AWS SDK pour C\+\+ ](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateForecast) + [AWS SDK pour Go v2 ](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateForecast) + [AWS SDK pour Java V2 ](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateForecast) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateForecast) + [AWS SDK pour Kotlin ](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateForecast) + [AWS SDK pour PHP V3 ](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateForecast) + [AWS SDK pour Python (Boto3) ](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateForecast) + [AWS SDK pour Ruby V3 ](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateForecast)