View a markdown version of this page

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 formazione, devi specificare un ruolo IAM collegato al servizio che conceda ad Amazon Personalize PutObject le autorizzazioni 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 di 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 indica 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:.*:.*:.+

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\-_]*

Obbligatorio: sì

jobOutput

Il percorso del bucket Amazon S3 in cui è archiviato l'output del lavoro.

Tipo: oggetto DatasetExportJobOutput

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+=,.@\-_/]+

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.

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

È stato superato il numero massimo di tag che è possibile 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: