View a markdown version of this page

CreateForecast - Amazon Forecast
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursVoir aussi

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 »

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_SERIESensemble 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'QueryForecastopération. Pour exporter la prévision complète vers votre compartiment Amazon Simple Storage Service (Amazon S3), utilisez l'CreateForecastExportJobopé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 »

La plage de la prévision est déterminée par la ForecastHorizon valeur que vous spécifiez dans la CreatePredictor 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'ListForecastsopé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.

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 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'TimeSeriesSelectorobjet 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

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

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

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

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

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

Obligatoire : non

TimeSeriesSelector

Définit l'ensemble de séries chronologiques utilisées pour créer les prévisions dans un TimeSeriesIdentifiers objet.

L'TimeSeriesIdentifiersobjet a besoin des informations suivantes :

  • DataSource

  • Format

  • Schema

Type : objet TimeSeriesSelector

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

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 :