View a markdown version of this page

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

DescribeDatasetImportJob

Décrit une tâche d'importation de jeux de données créée à l'aide de CreateDatasetImportJob 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 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, des 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

Quand la tâche d'importation de l'ensemble de données a été créée.

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 de l'ensemble de données en gigaoctets (Go) une fois la tâche d'importation terminée.

Type : double

DataSource

L'emplacement des données d'entraînement à importer et le rôle Gestion des identités et des accès AWS (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

Temps estimé restant en minutes pour terminer la tâche d'importation de l'ensemble de données.

Type : Long

FieldStatistics

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

Type : mappage de la chaîne à Statistics l'objet

Contraintes relatives à la longueur des touches : longueur maximale de 256.

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

Format

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, COMPLET ou INCRÉMENTAL.

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

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 du jeu de données. Le format que vous spécifiez dépend de la date de création du jeu de données DataFrequency spécifiée. Les formats suivants sont pris en charge

  • « aaaa- MM-dd »

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

  • « aaaa- MM-dd 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

Fuseau horaire unique appliqué à chaque élément de l'ensemble de données

Type : Chaîne

Contraintes de longueur : longueur maximale de 256.

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

UseGeolocationForTimeZone

Indique si elle TimeZone est automatiquement dérivée de l'attribut de géolocalisation.

Type : Boolean

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 :