DescribeDatasetImportJob - Amazon Forecast

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.

DescribeDatasetImportJob

Décrit une tâche d'importation de jeu de données créée à l'aide de CreateDatasetImportJobcette opération.

Outre la liste des paramètres fournis dans la CreateDatasetImportJob demande, cette opération inclut les propriétés suivantes :

  • CreationTime

  • LastModificationTime

  • DataSize

  • FieldStatistics

  • Status

  • Message- Si une erreur s'est produite, informations sur l'erreur.

Syntaxe de la requête

{ "DatasetImportJobArn": "string" }

Paramètres de demande

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

DatasetImportJobArn

Le nom de ressource Amazon (ARN) de la tâche d'importation de l'ensemble de données.

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, "DatasetArn": "string", "DatasetImportJobArn": "string", "DatasetImportJobName": "string", "DataSize": number, "DataSource": { "S3Config": { "KMSKeyArn": "string", "Path": "string", "RoleArn": "string" } }, "EstimatedTimeRemainingInMinutes": number, "FieldStatistics": { "string" : { "Avg": number, "Count": number, "CountDistinct": number, "CountDistinctLong": number, "CountLong": number, "CountNan": number, "CountNanLong": number, "CountNull": number, "CountNullLong": number, "Max": "string", "Min": "string", "Stddev": number } }, "Format": "string", "GeolocationFormat": "string", "ImportMode": "string", "LastModificationTime": number, "Message": "string", "Status": "string", "TimestampFormat": "string", "TimeZone": "string", "UseGeolocationForTimeZone": boolean }

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 de création de la tâche d'importation de l'ensemble de données.

Type : Timestamp

DatasetArn

Le nom de ressource Amazon (ARN) de l'ensemble de données dans lequel les données d'entraînement ont été importées.

Type : chaîne

Contraintes de longueur : longueur maximale de 256.

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

DatasetImportJobArn

L'ARN de la tâche d'importation du jeu de données.

Type : chaîne

Contraintes de longueur : longueur maximale de 256.

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

DatasetImportJobName

Nom de la tâche d'importation de l'ensemble de données.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63.

Modèle : ^[a-zA-Z][a-zA-Z0-9_]*

DataSize

Taille du jeu de données en gigaoctets (Go) une fois le travail d'importation terminé.

Type : double

DataSource

L'emplacement des données d'entraînement à importer et le rôle AWS Identity and Access Management (IAM) qu'Amazon Forecast peut assumer pour accéder aux données.

Si le chiffrement est utilisé, DataSource inclut une clé AWS Key Management Service (KMS).

Type : objet DataSource

EstimatedTimeRemainingInMinutes

Durée estimée restant, en minutes, pour terminer la tâche d'importation du jeu de données.

Type : long

FieldStatistics

Informations statistiques sur chaque champ des données d'entrée.

Type : mappage entre chaîne et Statistics objet

Contraintes relatives à la longueur des clés : longueur maximale de 256.

Modèle de clé :^[a-zA-Z0-9\_]+$

Format

Le format des données importées, CSV ou PARQUET.

Type : chaîne

Contraintes de longueur : longueur maximale de 7.

Modèle : ^CSV|PARQUET$

GeolocationFormat

Format de l'attribut de géolocalisation. Valeurs valides : "LAT_LONG" et "CC_POSTALCODE".

Type : chaîne

Contraintes de longueur : longueur maximale de 256.

Modèle : ^[a-zA-Z0-9_]+$

ImportMode

Mode d'importation de la tâche d'importation de l'ensemble de données, FULL ou INCREMENTAL.

Type : chaîne

Valeurs valides : FULL | INCREMENTAL

LastModificationTime

La dernière fois que la ressource a été modifiée. 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é.

  • ACTIVEou CREATE_FAILED - Lorsque le travail s'est terminé ou a échoué.

Type : Timestamp

Message

Si une erreur s'est produite, un message d'information la concernant.

Type : chaîne

Status

État de la tâche d'importation de l'ensemble de données. Les États incluent :

  • ACTIVE

  • CREATE_PENDING, CREATE_IN_PROGRESS, CREATE_FAILED

  • DELETE_PENDING, DELETE_IN_PROGRESS, DELETE_FAILED

  • CREATE_STOPPING, CREATE_STOPPED

Type : chaîne

Contraintes de longueur : longueur maximale de 256.

TimestampFormat

Format des horodatages dans le jeu de données. Le format que vous spécifiez dépend du moment où le DataFrequency jeu de données a été créé. Les formats suivants sont pris en charge

  • « YYYY-MM-DD »

    Pour les fréquences de données suivantes : Y, M, W et D

  • "aaaa-MM-jj HH:mm:ss"

    Pour les fréquences de données suivantes : H, 30 min, 15 min et 1 min ; et éventuellement, pour : Y, M, W et D

Type : chaîne

Contraintes de longueur : longueur maximale de 256.

Modèle : ^[a-zA-Z0-9\-\:\.\,\'\s]+$

TimeZone

Le fuseau horaire unique appliqué à chaque élément du jeu de données

Type : chaîne

Contraintes de longueur : longueur maximale de 256.

Modèle : ^[a-zA-Z0-9\/\+\-\_]+$

UseGeolocationForTimeZone

S'il TimeZone est automatiquement dérivé de l'attribut de géolocalisation.

Type : booléen

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

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 :