View a markdown version of this page

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

CreateDatasetImportJob

Importe vos données d'entraînement dans un jeu de données Amazon Forecast. Vous indiquez l'emplacement de vos données d'entraînement dans un compartiment Amazon Simple Storage Service (Amazon S3) et le nom de ressource Amazon (ARN) du jeu de données dans lequel vous souhaitez importer les données.

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 »

Vous devez spécifier un DataSource objet qui inclut un rôle Gestion des identités et des accès AWS (IAM) qu'Amazon Forecast peut assumer pour accéder aux données, car Amazon Forecast copie vos données et les traite dans un AWS système interne. Pour plus d'informations, consultez la section Configuration des autorisations.

Les données de formation doivent être au format CSV ou Parquet. Le délimiteur doit être une virgule (,).

Vous pouvez spécifier le chemin d'accès à un fichier spécifique, au compartiment S3 ou à un dossier du compartiment S3. Dans les deux derniers cas, Amazon Forecast importe tous les fichiers dans la limite de 10 000 fichiers.

Comme les importations d'ensembles de données ne sont pas agrégées, votre importation d'ensemble de données la plus récente est celle qui est utilisée lors de la formation d'un prédicteur ou de la génération d'une prévision. Assurez-vous que votre dernière importation de jeu de données contient toutes les données sur lesquelles vous souhaitez modéliser, et pas uniquement les nouvelles données collectées depuis l'importation précédente.

Pour obtenir la liste de toutes vos tâches d'importation de jeux de données, filtrées selon des critères spécifiques, utilisez l'ListDatasetImportJobsopération.

Syntaxe de la requête

{
   "DatasetArn": "string",
   "DatasetImportJobName": "string",
   "DataSource": { 
      "S3Config": { 
         "KMSKeyArn": "string",
         "Path": "string",
         "RoleArn": "string"
      }
   },
   "Format": "string",
   "GeolocationFormat": "string",
   "ImportMode": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TimestampFormat": "string",
   "TimeZone": "string",
   "UseGeolocationForTimeZone": boolean
}

Paramètres de demande

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

DatasetArn

Le nom de ressource Amazon (ARN) du jeu de données Amazon Forecast dans lequel vous souhaitez importer des données.

Type : Chaîne

Contraintes de longueur : longueur maximale de 256.

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

Obligatoire : oui

DatasetImportJobName

Le nom de la tâche d'importation de l'ensemble de données. Nous vous recommandons d'inclure l'horodatage actuel dans le nom, par exemple. 20190721DatasetImport Cela peut vous aider à éviter d'obtenir une ResourceAlreadyExistsException exception.

Type : Chaîne

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

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

Obligatoire : oui

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. Les données d'entraînement doivent être stockées dans un compartiment Amazon S3.

Si le chiffrement est utilisé, DataSource il doit inclure une clé AWS Key Management Service (KMS) et le rôle IAM doit autoriser Amazon Forecast à accéder à la clé. La clé KMS et le rôle IAM doivent correspondre à ceux spécifiés dans le EncryptionConfig paramètre de l'CreateDatasetopération.

Type : objet DataSource

Obligatoire : oui

Format

Format des données importées, CSV ou PARQUET. La valeur par défaut est CSV.

Type : Chaîne

Contraintes de longueur : longueur maximale de 7.

Modèle : ^CSV|PARQUET$

Obligatoire : non

GeolocationFormat

Format de l'attribut de géolocalisation. L'attribut de géolocalisation peut être formaté de deux manières :

  • LAT_LONG- la latitude et la longitude au format décimal (Exemple : 47.61_-122.33).

  • CC_POSTALCODE(États-Unis uniquement) : code du pays (États-Unis), suivi du code postal à 5 chiffres (exemple : US_98121).

Type : Chaîne

Contraintes de longueur : longueur maximale de 256.

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

Obligatoire : non

ImportMode

Spécifie si la tâche d'importation de l'ensemble de données est une tâche FULL ou une INCREMENTAL importation. L'importation d'un FULL jeu de données remplace toutes les données existantes par les données récemment importées. Une INCREMENTAL importation ajoute les données importées aux données existantes.

Type : Chaîne

Valeurs valides : FULL | INCREMENTAL

Obligatoire : non

Tags

Les métadonnées facultatives que vous appliquez à la tâche d'importation de jeux de données pour vous aider à les classer et à les organiser. Chaque balise est constituée d’une clé et d’une valeur facultative que vous définissez.

Les restrictions de base suivantes s’appliquent aux balises :

  • Nombre maximum de balises par ressource : 50.

  • Pour chaque ressource, chaque clé d'identification doit être unique, et chaque clé d'identification peut avoir une seule valeur.

  • Longueur de clé maximale : 128 caractères Unicode. UTF-8

  • Longueur de valeur maximale : 256 caractères Unicode. UTF-8

  • Si votre schéma de balisage est utilisé pour plusieurs services et ressources , n’oubliez pas que d’autres services peuvent avoir des restrictions concernant les caractères autorisés. Les caractères généralement autorisés sont : les lettres, les chiffres et les espaces pouvant être représentés par UTF-8, et les caractères suivants : + - =. _ :/@.

  • Les clés et les valeurs des balises font la distinction entre majuscules et minuscules.

  • N'utilisez pas aws:AWS:, ou toute combinaison majuscule ou minuscule de ce type, comme préfixe pour les clés, car son utilisation est réservée. AWS Vous ne pouvez ni modifier ni supprimer les clés de tag avec ce préfixe. Les valeurs peuvent avoir ce préfixe. Si une valeur de balise a aws pour préfixe mais pas la clé, Forecast considère qu'il s'agit d'une balise utilisateur et sera prise en compte dans la limite de 50 balises. Les balises dont le seul préfixe clé est ne sont aws pas prises en compte dans vos balises par limite de ressource.

Type : tableau d’objets Tag

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

Obligatoire : non

TimestampFormat

Format des horodatages de l'ensemble 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

Si le format n'est pas spécifié, Amazon Forecast s'attend à ce que le format soit « aaaa- MM-dd HH:mm:ss ».

Type : Chaîne

Contraintes de longueur : longueur maximale de 256.

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

Obligatoire : non

TimeZone

Un fuseau horaire unique pour chaque élément de votre jeu de données. Cette option est idéale pour les ensembles de données dont tous les horodatages se trouvent dans un seul fuseau horaire, ou si tous les horodatages sont normalisés dans un seul fuseau horaire.

Consultez l'Joda-TimeAPI pour obtenir la liste complète des noms de fuseaux horaires valides.

Type : Chaîne

Contraintes de longueur : longueur maximale de 256.

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

Obligatoire : non

UseGeolocationForTimeZone

Dérivez automatiquement les informations de fuseau horaire à partir de l'attribut de géolocalisation. Cette option est idéale pour les ensembles de données contenant des horodatages dans plusieurs fuseaux horaires et ces horodatages sont exprimés en heure locale.

Type : booléen

Obligatoire : non

Syntaxe de la réponse

{
   "DatasetImportJobArn": "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.

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:.*:.*:.+

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

LimitExceededException

La limite du nombre de ressources par compte a été dépassée.

Code d’état HTTP : 400

ResourceAlreadyExistsException

Il existe déjà une ressource portant ce nom. Réessayez avec un autre nom.

Code d’état HTTP : 400

ResourceInUseException

La ressource spécifiée est en cours d'utilisation.

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 :