View a markdown version of this page

CreateAutoPredictor - 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.

CreateAutoPredictor

Crée un prédicteur Amazon Forecast.

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 »

Amazon Forecast crée des prédicteurs avec AutoPredictor, ce qui implique d'appliquer la combinaison optimale d'algorithmes à chaque série chronologique de vos ensembles de données. Vous pouvez l'utiliser CreateAutoPredictor pour créer de nouveaux prédicteurs ou des prédicteurs upgrade/retrain existants.

Création de nouveaux prédicteurs

Les paramètres suivants sont requis lors de la création d'un nouveau prédicteur :

  • PredictorName- Un nom unique pour le prédicteur.

  • DatasetGroupArn- L'ARN du groupe de données utilisé pour entraîner le prédicteur.

  • ForecastFrequency- La granularité de vos prévisions (horaires, quotidiennes, hebdomadaires, etc.)

  • ForecastHorizon- Le nombre de pas temporels que le modèle prédit. L’horizon de prévision est également appelé longueur de prédiction.

Lorsque vous créez un nouveau prédicteur, ne spécifiez pas de valeur pourReferencePredictorArn.

Mise à niveau et recyclage des prédicteurs

Les paramètres suivants sont requis lors du réentraînement ou de la mise à niveau d'un prédicteur :

  • PredictorName- Un nom unique pour le prédicteur.

  • ReferencePredictorArn- L'ARN du prédicteur à recycler ou à mettre à niveau.

Lors de la mise à niveau ou du réentraînement d'un prédicteur, spécifiez uniquement des valeurs pour le ReferencePredictorArn et. PredictorName

Syntaxe de la requête

{
   "DataConfig": { 
      "AdditionalDatasets": [ 
         { 
            "Configuration": { 
               "string" : [ "string" ]
            },
            "Name": "string"
         }
      ],
      "AttributeConfigs": [ 
         { 
            "AttributeName": "string",
            "Transformations": { 
               "string" : "string" 
            }
         }
      ],
      "DatasetGroupArn": "string"
   },
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "ExplainPredictor": boolean,
   "ForecastDimensions": [ "string" ],
   "ForecastFrequency": "string",
   "ForecastHorizon": number,
   "ForecastTypes": [ "string" ],
   "MonitorConfig": { 
      "MonitorName": "string"
   },
   "OptimizationMetric": "string",
   "PredictorName": "string",
   "ReferencePredictorArn": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimeAlignmentBoundary": { 
      "DayOfMonth": number,
      "DayOfWeek": "string",
      "Hour": number,
      "Month": "string"
   }
}

Paramètres de demande

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

DataConfig

La configuration des données pour votre groupe de jeux de données et tous les jeux de données supplémentaires.

Type : objet DataConfig

Obligatoire : non

EncryptionConfig

Une clé AWS Key Management Service (KMS) et un rôle Gestion des identités et des accès AWS (IAM) qu'Amazon Forecast peut assumer pour accéder à la clé. Vous pouvez spécifier cet objet facultatif dans les CreatePredictor requêtes CreateDataset et.

Type : objet EncryptionConfig

Obligatoire : non

ExplainPredictor

Créez une ressource d'explicabilité pour le prédicteur.

Type : booléen

Obligatoire : non

ForecastDimensions

Tableau de noms de dimensions (champs) qui indiquent comment regrouper les prévisions générées.

Par exemple, si vous générez des prévisions pour les ventes d'articles dans toutes vos boutiques et store_id que votre jeu de données contient un store_id champ, vous devez spécifier une dimension pour regrouper les prévisions de ventes pour chaque boutique.

Type : tableau de chaînes

Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 10 éléments.

Contraintes de longueur : longueur minimale de 1 caractère. Longueur maximum de 63.

Modèle : ^[a-zA-Z][a-zA-Z0-9_]*

Obligatoire : non

ForecastFrequency

La fréquence des prévisions dans une prévision.

Les intervalles valides sont un nombre entier suivi de Y (année), M (mois), W (semaine), D (jour), H (heure) et min (minute). Par exemple, « 1D » indique tous les jours et « 15min » indique toutes les 15 minutes. Vous ne pouvez pas spécifier une valeur qui chevaucherait la fréquence supérieure suivante. Cela signifie, par exemple, que vous ne pouvez pas spécifier une fréquence de 60 minutes, car cela équivaut à 1 heure. Les valeurs valides pour chaque fréquence sont les suivantes :

  • Minute : 1 à 59

  • Heure : 1 à 23

  • Jour : 1 à 6

  • Semaine : 1 à 4

  • Mois : 1 à 11

  • Année : 1

Ainsi, si vous souhaitez des prévisions toutes les deux semaines, spécifiez « 2W ». Ou, si vous souhaitez des prévisions trimestrielles, spécifiez « 3M ».

La fréquence doit être supérieure ou égale à la fréquence du jeu de données TARGET_TIME_SERIES.

Lorsqu'un jeu de données RELATED_TIME_SERIES est fourni, la fréquence doit être égale à la fréquence du jeu de données RELATED_TIME_SERIES.

Type : Chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 5.

Modèle : ^Y|M|W|D|H|30min|15min|10min|5min|1min$

Obligatoire : non

ForecastHorizon

Le nombre de pas temporels que le modèle prédit. L’horizon de prévision est également appelé longueur de prédiction.

L'horizon de prévision maximal est le moins élevé entre 500 pas temporels ou la longueur du jeu 1/4 de données TARGET_TIME_SERIES. Si vous réentraînez un existant AutoPredictor, l'horizon de prévision maximal est le moins élevé entre 500 pas temporels ou la longueur du jeu de données 1/3 TARGET_TIME_SERIES.

Si vous effectuez une mise à niveau vers un modèle existant AutoPredictor ou que vous renouvelez votre formation AutoPredictor, vous ne pouvez pas mettre à jour le paramètre de l'horizon de prévision. Vous pouvez répondre à cette exigence en fournissant des séries chronologiques plus longues dans l'ensemble de données.

Type : Integer

Obligatoire : non

ForecastTypes

Les types de prévisions utilisés pour entraîner un prédicteur. Vous pouvez spécifier jusqu'à cinq types de prévisions. Les types de prévisions peuvent être des quantiles compris entre 0,01 et 0,99, par incréments de 0,01 ou plus. Vous pouvez également spécifier la prévision moyenne avecmean.

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

MonitorConfig

Les détails de configuration pour la surveillance des prédicteurs. Donnez un nom à la ressource de surveillance afin d'activer la surveillance des prédicteurs.

La surveillance des prédicteurs vous permet de voir comment les performances de votre prédicteur évoluent au fil du temps. Pour plus d'informations, consultez la section Surveillance des prédicteurs.

Type : objet MonitorConfig

Obligatoire : non

OptimizationMetric

La métrique de précision utilisée pour optimiser le prédicteur.

Type : Chaîne

Valeurs valides : WAPE | RMSE | AverageWeightedQuantileLoss | MASE | MAPE

Obligatoire : non

PredictorName

Un nom unique pour le prédicteur

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

ReferencePredictorArn

L'ARN du prédicteur à recycler ou à mettre à niveau. Ce paramètre n'est utilisé que lors du réentraînement ou de la mise à niveau d'un prédicteur. Lorsque vous créez un nouveau prédicteur, ne spécifiez pas de valeur pour ce paramètre.

Lors de la mise à niveau ou du réentraînement d'un prédicteur, spécifiez uniquement des valeurs pour le ReferencePredictorArn et. PredictorName La valeur de PredictorName doit être un nom de prédicteur unique.

Type : Chaîne

Contraintes de longueur : longueur maximale de 256.

Modèle : arn:([a-z\d-]+):forecast:.*:.*:.+

Obligatoire : non

Tags

Des métadonnées facultatives pour vous aider à classer et à organiser vos prédicteurs. Chaque balise est constituée d’une clé et d’une valeur facultative que vous définissez. Les clés et les valeurs des balises font la distinction entre majuscules et minuscules.

Les restrictions suivantes s’appliquent aux balises :

  • Pour chaque ressource, chaque clé de balise doit être unique et chaque clé de balise doit avoir une valeur.

  • Nombre maximum de balises par ressource : 50.

  • Longueur de clé maximale : 128 caractères Unicode. UTF-8

  • Longueur de valeur maximale : 256 caractères Unicode au UTF-8 format.

  • Caractères acceptés : toutes les lettres et tous les chiffres, les espaces peuvent être représentés et + - =. UTF-8 _ :/@. Si votre schéma de balisage est utilisé dans d'autres services et ressources, les restrictions de caractères de ces services s'appliquent également.

  • Les préfixes clés ne peuvent inclure aucune combinaison majuscule ou minuscule de ou. aws: AWS: 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. Vous ne pouvez ni modifier ni supprimer les clés de tag avec ce préfixe.

Type : tableau d’objets Tag

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

Obligatoire : non

TimeAlignmentBoundary

La limite temporelle que Forecast utilise pour aligner et agréger toutes les données qui ne correspondent pas à la fréquence de vos prévisions. Indiquez l'unité de temps et la limite de temps sous forme de paire de valeurs clés. Pour plus d'informations sur la définition d'une limite de temps, voir Spécifier une limite de temps. Si vous ne fournissez pas de limite de temps, Forecast utilise un ensemble de limites de temps par défaut.

Type : objet TimeAlignmentBoundary

Obligatoire : non

Syntaxe de la réponse

{
   "PredictorArn": "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.

PredictorArn

Le nom de ressource Amazon (ARN) du prédicteur.

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 :