Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CreateDatasetExportJob
Crea un job che esporta i dati dal tuo set di dati in un bucket Amazon S3. Per consentire ad Amazon Personalize di esportare i dati di addestramento, devi specificare un ruolo IAM collegato al servizio che fornisca le autorizzazioni di Amazon Personalize PutObject
per il tuo bucket Amazon S3. Per informazioni, consulta Esportazione di un set di dati nella guida per sviluppatori di Amazon Personalize.
Stato
Un processo di esportazione del set di dati può trovarsi in uno dei seguenti stati:
-
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -oppure- CREATE FAILED
Per conoscere lo stato del processo di esportazione DescribeDatasetExportJob, chiama e specifica l'Amazon Resource Name (ARN) del processo di esportazione del set di dati. L'esportazione del set di dati è completa quando lo stato viene visualizzato come ATTIVO. Se lo stato è impostato su CREATE FAILED, la risposta include una failureReason
chiave che descrive il motivo per cui il processo non è riuscito.
Sintassi della richiesta
{
"datasetArn": "string
",
"ingestionMode": "string
",
"jobName": "string
",
"jobOutput": {
"s3DataDestination": {
"kmsKeyArn": "string
",
"path": "string
"
}
},
"roleArn": "string
",
"tags": [
{
"tagKey": "string
",
"tagValue": "string
"
}
]
}
Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- datasetArn
-
L'Amazon Resource Name (ARN) del set di dati che contiene i dati da esportare.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+
Campo obbligatorio: sì
- ingestionMode
-
I dati da esportare, in base a come li hai importati. È possibile scegliere di esportare solo
BULK
i dati importati utilizzando un processo di importazione del set di dati, soloPUT
i dati importati in modo incrementale (utilizzando la console PutUsers e PutItems le operazioni) oALL
per entrambi i tipi. PutEvents Il valore predefinito èPUT
.Tipo: stringa
Valori validi:
BULK | PUT | ALL
Campo obbligatorio: no
- jobName
-
Il nome del processo di esportazione del set di dati.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.
Modello:
^[a-zA-Z0-9][a-zA-Z0-9\-_]*
Campo obbligatorio: sì
- jobOutput
-
Il percorso verso il bucket Amazon S3 in cui è archiviato l'output del processo.
Tipo: oggetto DatasetExportJobOutput
Campo obbligatorio: sì
- roleArn
-
L'Amazon Resource Name (ARN) del ruolo del servizio IAM che dispone delle autorizzazioni per aggiungere dati al bucket Amazon S3 di output.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+
Campo obbligatorio: sì
-
Un elenco di tag da applicare al processo di esportazione del set di dati.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
Campo obbligatorio: no
Sintassi della risposta
{
"datasetExportJobArn": "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.
- datasetExportJobArn
-
L'Amazon Resource Name (ARN) del processo di esportazione del set di dati.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+
Errori
- InvalidInputException
-
Fornisci un valore valido per il campo o il parametro.
Codice di stato HTTP: 400
- LimitExceededException
-
Il limite del numero di richieste al secondo è stato superato.
Codice di stato HTTP: 400
- ResourceAlreadyExistsException
-
La risorsa specificata esiste già.
Codice di stato HTTP: 400
- ResourceInUseException
-
La risorsa specificata è in uso.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Impossibile trovare la risorsa specificata.
Codice di stato HTTP: 400
- TooManyTagsException
-
Hai superato il numero massimo di tag che puoi applicare a questa risorsa.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: