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.
CreateWhatIfAnalysis
L'analyse hypothétique est une technique de modélisation de scénarios dans laquelle vous apportez une modification hypothétique à une série chronologique et comparez les prévisions générées par ces modifications à la série chronologique de référence inchangée. Il est important de se rappeler que le but d'une analyse hypothétique est de comprendre comment une prévision peut changer en fonction des différentes modifications apportées à la série chronologique de référence.
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 »
Par exemple, imaginez que vous êtes un détaillant de vêtements qui envisage une vente de fin de saison pour libérer de l'espace pour de nouveaux styles. Après avoir créé une prévision de référence, vous pouvez utiliser une analyse hypothétique pour déterminer comment les différentes tactiques de vente peuvent affecter vos objectifs.
Vous pourriez créer un scénario où tout reçoit une réduction de 25 %, et un autre où tout reçoit une réduction fixe en dollars. Vous pouvez créer un scénario dans lequel la vente dure une semaine et un autre dans lequel la vente dure un mois. Grâce à une analyse hypothétique, vous pouvez comparer de nombreux scénarios différents les uns par rapport aux autres.
Notez qu'une analyse hypothétique est destinée à montrer ce que le modèle de prévision a appris et comment il se comportera dans les scénarios que vous évaluez. N'utilisez pas aveuglément les résultats de l'analyse hypothétique pour prendre des décisions commerciales. Par exemple, les prévisions peuvent ne pas être exactes pour les nouveaux scénarios dans lesquels aucune référence n'est disponible pour déterminer si une prévision est bonne.
L'TimeSeriesSelectorobjet définit les éléments que vous souhaitez inclure dans l'analyse hypothétique.
Note
Vos données doivent être au format valeurs séparées par des virgules (CSV) pour créer une analyse hypothétique.
Syntaxe de la requête
{
"ForecastArn": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
],
"TimeSeriesSelector": {
"TimeSeriesIdentifiers": {
"DataSource": {
"S3Config": {
"KMSKeyArn": "string
",
"Path": "string
",
"RoleArn": "string
"
}
},
"Format": "string
",
"Schema": {
"Attributes": [
{
"AttributeName": "string
",
"AttributeType": "string
"
}
]
}
}
},
"WhatIfAnalysisName": "string
"
}
Paramètres de demande
La demande accepte les données suivantes au JSON format suivant.
- ForecastArn
-
Nom de la ressource Amazon (ARN) de la prévision de base.
Type : String
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):forecast:.*:.*:.+
Obligatoire : oui
- 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
- TimeSeriesSelector
-
Définit l'ensemble des séries chronologiques utilisées dans l'analyse hypothétique d'un
TimeSeriesIdentifiers
objet. Les analyses hypothétiques ne sont effectuées que pour les séries chronologiques de cet objet.L'
TimeSeriesIdentifiers
objet a besoin des informations suivantes :-
DataSource
-
Format
-
Schema
Type : objet TimeSeriesSelector
Obligatoire : non
-
- WhatIfAnalysisName
-
Nom de l'analyse hypothétique. Chaque nom doit être unique.
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
{
"WhatIfAnalysisArn": "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.
- 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:.*:.*:.+
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 :