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

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.

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 CSV (valeurs séparées par des virgules) 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

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

ForecastArn

Le nom de ressource Amazon (ARN) de la prévision de base.

Type : chaîne

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 sont effectuées uniquement pour les séries chronologiques de cet objet.

L'TimeSeriesIdentifiersobjet 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 : chaîne

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 au format JSON par le service.

WhatIfAnalysisArn

Le nom de ressource Amazon (ARN) de l'analyse hypothétique.

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 :