CreateAutoPredictor - Amazon Forecast
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursconsultez 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 les utiliser CreateAutoPredictor pour créer de nouveaux prédicteurs ou mettre à niveau/réentraîner les prédicteurs 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- Le ARN nom 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 d'étapes temporelles prédites par le modèle. 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 réentraînement 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- Le ARN prédicteur à réentraîner ou à améliorer.

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

La demande accepte les données suivantes au JSON format suivant.

DataConfig

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

Type : objet DataConfig

Obligatoire : non

EncryptionConfig

Une clé AWS Key Management Service (KMS) et un rôle AWS Identity and Access Management (IAM) qu'Amazon Forecast peut assumer pour accéder à la clé. Vous pouvez spécifier cet objet facultatif dans les CreatePredictor demandes 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 indique 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 tous vos magasins et que votre jeu de données contient un store_id champ, vous devez le spécifier store_id comme 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 minimum de 1. Longueur maximum de 63.

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

Obligatoire : non

ForecastFrequency

Fréquence des prédictions contenues 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 SERIES données TARGET TIME _ _.

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

Type : String

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

Nombre d'étapes temporelles prédites par le modèle. L'horizon de prévision est également appelé longueur de prédiction.

L'horizon de prévision maximal est le moins élevé des valeurs suivantes : 500 pas temporels ou 1/4 de la longueur du jeu de SERIES données TARGET TIME _ _. Si vous réentraînez un objet existant AutoPredictor, l'horizon de prévision maximal est le moins élevé des deux montants suivants : 500 pas temporels ou 1/3 de la longueur du jeu de SERIES données TARGET _ TIME _.

Si vous effectuez une mise à niveau AutoPredictor ou que vous reformez un existant 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 le jeu de données.

Type : entier

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 Predictor Monitoring.

Type : objet MonitorConfig

Obligatoire : non

OptimizationMetric

Mesure de précision utilisée pour optimiser le prédicteur.

Type : String

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

Obligatoire : non

PredictorName

Nom unique pour le prédicteur

Type : String

Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63.

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

Obligatoire : oui

ReferencePredictorArn

Le ARN prédicteur à réentraîner ou à améliorer. Ce paramètre est uniquement utilisé 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 : String

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 valeurs de balise sont sensibles à la casse.

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 maximale de la clé : 128 caractères Unicode en UTF -8.

  • Longueur maximale de la valeur : 256 caractères Unicode en UTF -8.

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

  • Les préfixes clés ne peuvent inclure aucune combinaison majuscules ou minuscules 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 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 ». Vous ne pouvez pas modifier ou supprimer les clés de balise 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 utilisée par Forecast pour aligner et agréger 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 clé-valeur. Pour plus d'informations sur la définition d'une limite de temps, consultez la section Spécification d'une limite de temps. Si vous ne fournissez pas de limite de temps, Forecast utilise un ensemble de limites temporelles 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 sous JSON forme formatée par le service.

PredictorArn

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

Type : String

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.

HTTPCode de statut : 400

LimitExceededException

La limite du nombre de ressources par compte a été dépassée.

HTTPCode de statut : 400

ResourceAlreadyExistsException

Il existe déjà une ressource portant ce nom. Réessayez avec un autre nom.

HTTPCode de statut : 400

ResourceInUseException

La ressource spécifiée est en cours d'utilisation.

HTTPCode de statut : 400

ResourceNotFoundException

Nous ne trouvons aucune ressource portant ce nom de ressource Amazon (ARN). Vérifiez le ARN et réessayez.

HTTPCode de statut : 400

consultez aussi

Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :