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é. -
ACTIVE
ouCREATE_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 :