View a markdown version of this page

ListDatasetImportJobs - Amazon Forecast

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.

ListDatasetImportJobs

Renvoie la liste des tâches d'importation d'ensembles de données créées à l'aide de l'CreateDatasetImportJobopération. Pour chaque tâche d'importation, cette opération renvoie un résumé de ses propriétés, y compris son Amazon Resource Name (ARN). Vous pouvez récupérer l'ensemble complet des propriétés en utilisant l'ARN avec l'DescribeDatasetImportJobopération. Vous pouvez filtrer la liste en fournissant un tableau d'objets Filter.

Syntaxe de la requête

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

Paramètres de demande

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

Filters

Une gamme de filtres. Pour chaque filtre, vous indiquez une condition et un énoncé de correspondance. La condition est soit IS ouIS_NOT, qui spécifie s'il faut inclure ou exclure les ensembles de données correspondant à l'instruction de la liste, respectivement. 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. Pour inclure les ensembles de données qui correspondent à l'instruction, spécifiezIS. Pour exclure les ensembles de données correspondants, spécifiezIS_NOT.

  • Key- Le nom du paramètre sur lequel filtrer. Les valeurs valides sont DatasetArn et Status.

  • Value- La valeur à égaler.

Par exemple, pour répertorier toutes les tâches d'importation de jeux de données dont le statut est ACTIF, vous spécifiez le filtre suivant :

"Filters": [ { "Condition": "IS", "Key": "Status", "Value": "ACTIVE" } ]

Type : tableau d’objets Filter

Obligatoire : non

MaxResults

Le nombre d'éléments à renvoyer dans la réponse.

Type : entier

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

Obligatoire : non

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

{ "DatasetImportJobs": [ { "CreationTime": number, "DatasetImportJobArn": "string", "DatasetImportJobName": "string", "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "ImportMode": "string", "LastModificationTime": number, "Message": "string", "Status": "string" } ], "NextToken": "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.

DatasetImportJobs

Tableau d'objets qui récapitule les propriétés de chaque tâche d'importation de jeux de données.

Type : tableau d’objets DatasetImportJobSummary

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.

Type : Chaîne

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

Modèle : .+

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

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 :