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.
DescribeForecast
Décrit une prévision créée à l'aide de CreateForecast cette opération.
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 »
Outre la liste des propriétés fournies dans la CreateForecast demande, cette opération répertorie les propriétés suivantes :
-
DatasetGroupArn- Le groupe de données qui a fourni les données d'entraînement. -
CreationTime -
LastModificationTime -
Status -
Message- En cas d'erreur, informations sur l'erreur.
Syntaxe de la requête
{
"ForecastArn": "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.
Type : Chaîne
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):forecast:.*:.*:.+Obligatoire : oui
Syntaxe de la réponse
{
"CreationTime": number,
"DatasetGroupArn": "string",
"EstimatedTimeRemainingInMinutes": number,
"ForecastArn": "string",
"ForecastName": "string",
"ForecastTypes": [ "string" ],
"LastModificationTime": number,
"Message": "string",
"PredictorArn": "string",
"Status": "string",
"TimeSeriesSelector": {
"TimeSeriesIdentifiers": {
"DataSource": {
"S3Config": {
"KMSKeyArn": "string",
"Path": "string",
"RoleArn": "string"
}
},
"Format": "string",
"Schema": {
"Attributes": [
{
"AttributeName": "string",
"AttributeType": "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.
- CreationTime
-
Date à laquelle la tâche de création de prévisions a été créée.
Type : Timestamp
- DatasetGroupArn
-
L'ARN du groupe de données qui a fourni les données utilisées pour entraîner le prédicteur.
Type : Chaîne
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):forecast:.*:.*:.+ - EstimatedTimeRemainingInMinutes
-
Temps estimé restant en minutes pour que la tâche de prévision soit terminée.
Type : Long
- ForecastArn
-
L'ARN de prévision tel que spécifié dans la demande.
Type : Chaîne
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):forecast:.*:.*:.+ - ForecastName
-
Le nom de la prévision.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63.
Modèle :
^[a-zA-Z][a-zA-Z0-9_]* - ForecastTypes
-
Quantiles auxquels les prévisions probabilistes ont été générées.
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$) - LastModificationTime
-
Dernière modification de la ressource. L'horodatage dépend du statut de la tâche :
-
CREATE_PENDING- LeCreationTime. -
CREATE_IN_PROGRESS- L'horodatage actuel. -
CREATE_STOPPING- L'horodatage actuel. -
CREATE_STOPPED- Quand le travail s'est arrêté. -
ACTIVEouCREATE_FAILED: lorsque la tâche s'est terminée ou a échoué.
Type : Timestamp
-
- Message
-
Si une erreur s'est produite, un message d'information concernant l'erreur.
Type : Chaîne
- PredictorArn
-
L'ARN du prédicteur utilisé pour générer la prévision.
Type : Chaîne
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):forecast:.*:.*:.+ - Status
-
État de la prévision. Les États incluent :
-
ACTIVE -
CREATE_PENDING,CREATE_IN_PROGRESS,CREATE_FAILED -
CREATE_STOPPING,CREATE_STOPPED -
DELETE_PENDING,DELETE_IN_PROGRESS,DELETE_FAILED
Note
Vous devez avoir obtenu la valeur
Statusde la prévisionACTIVEavant de pouvoir l'interroger ou l'exporter.Type : Chaîne
Contraintes de longueur : longueur maximale de 256.
Modèle :
^[a-zA-Z0-9\_]+$ -
- TimeSeriesSelector
-
La série chronologique à inclure dans les prévisions.
Type : objet TimeSeriesSelector
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
- 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 :
