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.
CreateWhatIfForecast
Une prévision hypothétique est une prévision créée à partir d'une version modifiée de la prévision de base. Chaque prévision hypothétique intègre soit un jeu de données de remplacement, soit un ensemble de transformations du jeu de données d'origine.
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 »
Syntaxe de la requête
{
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
],
"TimeSeriesReplacementsDataSource": {
"Format": "string
",
"S3Config": {
"KMSKeyArn": "string
",
"Path": "string
",
"RoleArn": "string
"
},
"Schema": {
"Attributes": [
{
"AttributeName": "string
",
"AttributeType": "string
"
}
]
},
"TimestampFormat": "string
"
},
"TimeSeriesTransformations": [
{
"Action": {
"AttributeName": "string
",
"Operation": "string
",
"Value": number
},
"TimeSeriesConditions": [
{
"AttributeName": "string
",
"AttributeValue": "string
",
"Condition": "string
"
}
]
}
],
"WhatIfAnalysisArn": "string
",
"WhatIfForecastName": "string
"
}
Paramètres de demande
La demande accepte les données suivantes au JSON format suivant.
- Tags
-
Une liste de balises à appliquer aux prévisions hypothétiques.
Type : tableau d’objets Tag
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.
Obligatoire : non
- TimeSeriesReplacementsDataSource
-
Le jeu de données de série chronologique de remplacement, qui contient les lignes que vous souhaitez modifier dans le jeu de données de séries chronologiques associé. Il n'est pas nécessaire qu'une série chronologique de remplacement contienne toutes les lignes de la série chronologique associée à la référence. N'incluez que les lignes (combinaisons de mesures et de dimensions) que vous souhaitez inclure dans les prévisions hypothétiques.
Ce jeu de données est fusionné avec la série chronologique d'origine pour créer un ensemble de données transformé qui est utilisé pour l'analyse hypothétique.
Cet ensemble de données doit contenir les éléments à modifier (tels que item_id ou workforce_type), toutes les dimensions pertinentes, la colonne d'horodatage et au moins l'une des colonnes de séries chronologiques associées. Ce fichier ne doit pas contenir d'horodatages dupliqués pour la même série chronologique. Ce fichier doit être au CSV format.
Les horodatages et les item_ids non inclus dans cet ensemble de données ne sont pas inclus dans l'analyse hypothétique.
Type : objet TimeSeriesReplacementsDataSource
Obligatoire : non
- TimeSeriesTransformations
-
Les transformations appliquées à la série chronologique de référence. Chaque transformation contient une action et un ensemble de conditions. Une action n'est appliquée que lorsque toutes les conditions sont remplies. Si aucune condition n'est spécifiée, l'action est appliquée à tous les éléments.
Type : tableau d’objets TimeSeriesTransformation
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 30 articles.
Obligatoire : non
- WhatIfAnalysisArn
-
Le nom de la ressource Amazon (ARN) de l'analyse hypothétique.
Type : String
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):forecast:.*:.*:.+
Obligatoire : oui
- WhatIfForecastName
-
Le nom de la prévision hypothétique. Les noms doivent être uniques dans chaque analyse hypothétique.
Type : String
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63.
Modèle :
^[a-zA-Z][a-zA-Z0-9_]*
Obligatoire : oui
Syntaxe de la réponse
{
"WhatIfForecastArn": "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.
- WhatIfForecastArn
-
Le nom de la ressource Amazon (ARN) de la prévision hypothétique.
Type : String
Contraintes de longueur : longueur maximale de 300.
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 :