CreateDatasetExportJob - Amazon Personalize
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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, solo PUT i dati importati in modo incrementale (utilizzando la console PutUsers e PutItems le operazioni) o ALL 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ì

tags

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 uno degli AWS SDK specifici della lingua, consulta quanto segue: