View a markdown version of this page

ListMonitorEvaluations - Amazon Forecast
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursVoir 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.

ListMonitorEvaluations

Renvoie une liste des résultats de l'évaluation de la surveillance et des événements prédictifs collectés par la ressource de surveillance au cours de différentes fenêtres temporelles.

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 »

Pour plus d'informations sur la surveillance, voirSurveillance des prédicteurs. Pour plus d'informations sur la récupération des résultats de surveillance, voir Affichage des résultats de surveillance.

Syntaxe de la requête

{
   "Filters": [ 
      { 
         "Condition": "string",
         "Key": "string",
         "Value": "string"
      }
   ],
   "MaxResults": number,
   "MonitorArn": "string",
   "NextToken": "string"
}

Paramètres de demande

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

Filters

Une gamme de filtres. Pour chaque filtre, indiquez une condition et un énoncé de correspondance. La condition est soit IS ouIS_NOT, qui spécifie s'il faut inclure ou exclure de la liste les ressources qui correspondent à l'instruction. L'instruction match se compose d'une clé et d'une valeur.

Propriétés du filtre

  • Condition- La condition à appliquer. Les valeurs valides sont IS et IS_NOT.

  • Key- Le nom du paramètre sur lequel filtrer. La seule valeur valide est EvaluationState.

  • Value- La valeur à égaler. Les valeurs valides sont uniquement SUCCESS ouFAILURE.

Par exemple, pour répertorier uniquement les évaluations de monitoring réussies, vous devez spécifier :

"Filters": [ { "Condition": "IS", "Key": "EvaluationState", "Value": "SUCCESS" } ]

Type : tableau d’objets Filter

Obligatoire : non

MaxResults

Le nombre maximum de résultats de surveillance à renvoyer.

Type : entier

Plage valide : valeur minimum de 1. Valeur maximale fixée à 100.

Obligatoire : non

MonitorArn

Le nom de ressource Amazon (ARN) de la ressource de surveillance à partir de laquelle obtenir les résultats.

Type : Chaîne

Contraintes de longueur : longueur maximale de 256.

Modèle : arn:([a-z\d-]+):forecast:.*:.*:.+

Obligatoire : oui

NextToken

Si le résultat de la demande précédente a été tronqué, la réponse inclut un. NextToken Pour récupérer la prochaine série de résultats, utilisez le jeton dans la demande suivante. Les jetons expirent au bout de 24 heures.

Type : Chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 3 000.

Modèle : .+

Obligatoire : non

Syntaxe de la réponse

{
   "NextToken": "string",
   "PredictorMonitorEvaluations": [ 
      { 
         "EvaluationState": "string",
         "EvaluationTime": number,
         "Message": "string",
         "MetricResults": [ 
            { 
               "MetricName": "string",
               "MetricValue": number
            }
         ],
         "MonitorArn": "string",
         "MonitorDataSource": { 
            "DatasetImportJobArn": "string",
            "ForecastArn": "string",
            "PredictorArn": "string"
         },
         "NumItemsEvaluated": number,
         "PredictorEvent": { 
            "Datetime": number,
            "Detail": "string"
         },
         "ResourceArn": "string",
         "WindowEndDatetime": number,
         "WindowStartDatetime": number
      }
   ]
}

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.

NextToken

Si la réponse est tronquée, Amazon Forecast renvoie ce jeton. Pour récupérer la prochaine série de résultats, utilisez le jeton dans la demande suivante. Les jetons expirent au bout de 24 heures.

Type : Chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximale de 3 000.

Modèle : .+

PredictorMonitorEvaluations

Les résultats de surveillance et les événements prédictifs collectés par la ressource de surveillance au cours de différentes fenêtres temporelles.

Pour plus d'informations sur la surveillance, voir Affichage des résultats de la surveillance. Pour plus d'informations sur la récupération des résultats de surveillance, voir Affichage des résultats de surveillance.

Type : tableau d’objets PredictorMonitorEvaluation

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

InvalidNextTokenException

Le jeton n'est pas valide. Les jetons expirent au bout de 24 heures.

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 :