Sintassi della richiesta Parametri della richiesta Sintassi della risposta Elementi di risposta Errori Vedi anche

CreateDatasetImportJob

Importa i tuoi dati di formazione in un set di dati Amazon Forecast. Fornisci la posizione dei tuoi dati di formazione in un bucket Amazon Simple Storage Service (Amazon S3) e l'Amazon Resource Name (ARN) del set di dati in cui desideri importare i dati.

Importante

Amazon Forecast non è più disponibile per i nuovi clienti. I clienti esistenti di Amazon Forecast possono continuare a utilizzare il servizio normalmente. Scopri di più»

Devi specificare un DataSource oggetto che includa un ruolo AWS Identity and Access Management (IAM) che Amazon Forecast può assumere per accedere ai dati, poiché Amazon Forecast crea una copia dei tuoi dati e li elabora in un AWS sistema interno. Per ulteriori informazioni, consulta Configurare le autorizzazioni.

I dati di allenamento devono essere in formato CSV o Parquet. Il delimitatore deve essere una virgola (,).

È possibile specificare il percorso di un file specifico, del bucket S3 o di una cartella nel bucket S3. Per gli ultimi due casi, Amazon Forecast importa tutti i file fino al limite di 10.000 file.

Poiché le importazioni di set di dati non sono aggregate, l'importazione più recente è quella utilizzata per l'addestramento di un predittore o la generazione di una previsione. Assicurati che l'importazione del set di dati più recente contenga tutti i dati da cui desideri modellare e non solo i nuovi dati raccolti dopo l'importazione precedente.

Per ottenere un elenco di tutti i processi di importazione dei set di dati, filtrati in base a criteri specificati, utilizza l'operazione. ListDatasetImportJobs

Sintassi della richiesta


{
   "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
}

Parametri della richiesta

La richiesta accetta i seguenti dati in formato JSON.

DatasetArn

L'Amazon Resource Name (ARN) del set di dati Amazon Forecast in cui desideri importare i dati.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: arn:([a-z\d-]+):forecast:.*:.*:.+

Obbligatorio: sì

DatasetImportJobName

Il nome del processo di importazione del set di dati. Consigliamo di includere il timestamp corrente nel nome, ad esempio,. 20190721DatasetImport Questo può aiutarti a evitare di ricevere un'ResourceAlreadyExistsExceptioneccezione.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.

Modello: ^[a-zA-Z][a-zA-Z0-9_]*

Obbligatorio: sì

DataSource

La posizione dei dati di formazione da importare e il ruolo AWS Identity and Access Management (IAM) che Amazon Forecast può assumere per accedere ai dati. I dati di training devono essere archiviati in un bucket Amazon S3.

Se viene utilizzata la crittografia, DataSource deve includere una chiave AWS Key Management Service (KMS) e il ruolo IAM deve consentire ad Amazon Forecast l'autorizzazione ad accedere alla chiave. La chiave KMS e il ruolo IAM devono corrispondere a quelli specificati nel EncryptionConfig parametro dell'CreateDatasetoperazione.

Tipo: oggetto DataSource

Obbligatorio: sì

Format

Il formato dei dati importati, CSV o PARQUET. Il valore predefinito è CSV.

Tipo: stringa

Vincoli di lunghezza: lunghezza massima di 7.

Modello: ^CSV|PARQUET$

Obbligatorio: no

GeolocationFormat

Il formato dell'attributo di geolocalizzazione. L'attributo di geolocalizzazione può essere formattato in due modi:

LAT_LONG- la latitudine e la longitudine in formato decimale (esempio: 47.61_-122.33).
CC_POSTALCODE(Solo Stati Uniti): il codice del paese (USA), seguito dal codice postale a 5 cifre (Esempio: US_98121).

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: ^[a-zA-Z0-9_]+$

Obbligatorio: no

ImportMode

Specifica se il processo di importazione del set di dati è un processo di importazione o di importazione. FULL INCREMENTAL L'importazione di un FULL set di dati sostituisce tutti i dati esistenti con i dati appena importati. Un'INCREMENTALimportazione aggiunge i dati importati ai dati esistenti.

Tipo: stringa

Valori validi: FULL | INCREMENTAL

Campo obbligatorio: no

Tags

I metadati opzionali che applichi al processo di importazione del set di dati per aiutarti a classificarli e organizzarli. Ogni tag è composto da una chiave e da un valore opzionale, entrambi personalizzabili.

Ai tag si applicano le seguenti limitazioni di base:

Numero massimo di tag per risorsa: 50.
Per ogni risorsa, ogni chiave di tag deve essere univoca e ogni chiave di tag può avere un solo valore.
Lunghezza massima della chiave: 128 caratteri Unicode in. UTF-8
Lunghezza massima del valore: 256 caratteri Unicode in. UTF-8
Se lo schema di assegnazione dei tag viene utilizzato in più servizi e risorse , tieni presente che altri servizi potrebbero prevedere limitazioni sui caratteri consentiti. I caratteri generalmente consentiti sono: lettere, numeri e spazi rappresentabili in UTF-8, e i seguenti caratteri: + - =. _:/@.
I valori e le chiavi dei tag rispettano la distinzione tra maiuscole e minuscole.
Non utilizzare aws: né alcuna combinazione di lettere maiuscole o minuscoleAWS:, ad esempio un prefisso per i tasti, poiché è riservato all'uso. AWS Non è possibile modificare o eliminare le chiavi dei tag con questo prefisso. I valori possono avere questo prefisso. Se un valore di tag ha aws come prefisso ma la chiave no, Forecast lo considera un tag utente e verrà conteggiato nel limite di 50 tag. I tag con il solo prefisso chiave di aws non vengono conteggiati nel calcolo dei tag per limite di risorse.

Tipo: matrice di oggetti Tag

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.

Obbligatorio: no

TimestampFormat

Il formato dei timestamp nel set di dati. Il formato specificato dipende da quello DataFrequency specificato al momento della creazione del set di dati. Sono supportati i seguenti formati

«yyyy-» MM-dd

Per le seguenti frequenze di dati: Y, M, W e D
«yyyy-» MM-dd HH:mm:ss

Per le seguenti frequenze di dati: H, 30min, 15min e 1min e, facoltativamente, per: Y, M, W e D

Se il formato non è specificato, Amazon Forecast prevede che sia «yyyy-». MM-dd HH:mm:ss

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

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

Obbligatorio: no

TimeZone

Un unico fuso orario per ogni elemento del tuo set di dati. Questa opzione è ideale per i set di dati con tutti i timestamp all'interno di un unico fuso orario o se tutti i timestamp sono normalizzati in un unico fuso orario.

Fai riferimento all'Joda-TimeAPI per un elenco completo dei nomi di fuso orario validi.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: ^[a-zA-Z0-9\/\+\-\_]+$

Obbligatorio: no

UseGeolocationForTimeZone

Ricava automaticamente le informazioni sul fuso orario dall'attributo di geolocalizzazione. Questa opzione è ideale per i set di dati che contengono timestamp in più fusi orari e tali timestamp sono espressi in ora locale.

Tipo: Booleano

Obbligatorio: no

Sintassi della risposta


{
   "DatasetImportJobArn": "string"
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

DatasetImportJobArn

L'Amazon Resource Name (ARN) del processo di importazione del set di dati.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

Modello: arn:([a-z\d-]+):forecast:.*:.*:.+

Errori

InvalidInputException

Non possiamo elaborare la richiesta perché include un valore non valido o un valore che supera l'intervallo valido.

Codice di stato HTTP: 400

LimitExceededException

Il limite del numero di risorse per account è stato superato.

Codice di stato HTTP: 400

ResourceAlreadyExistsException

Esiste già una risorsa con questo nome. Riprova con un nome diverso.

Codice di stato HTTP: 400

ResourceInUseException

La risorsa specificata è in uso.

Codice di stato HTTP: 400

ResourceNotFoundException

Non riusciamo a trovare una risorsa con tale Amazon Resource Name (ARN). Controlla l'ARN e riprova.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

CreateDatasetGroup

CreateExplainability