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

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 les prévisions pour un seul élément avec une faible latence, utilisez l'QueryForecastopération. Pour exporter les prévisions complètes dans votre compartiment Amazon Simple Storage Service (Amazon S3), utilisez l'CreateForecastExportJobopération.

La plage des prévisions est déterminée par la ForecastHorizon valeur que vous spécifiez dans la CreatePredictor demande. Lorsque vous recherchez une prévision, vous pouvez demander une plage de dates spécifique dans 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 plus d’informations, consultez Génération de prévisions.

Note

La prévision doit Status l'être ACTIVE avant que vous puissiez la consulter 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 jeux 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 à partir desquels 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, binomial bêta et négatif).

Les quantiles par défaut sont ceux 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

Nom de ressource Amazon (ARN) du prédicteur à utiliser pour générer les prévisions.

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 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 : + - = . _ : / @.

  • Les clés et valeurs de balise sont sensibles à la casse.

  • 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

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

Obligatoire : non

TimeSeriesSelector

Définit l'ensemble des 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

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :