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à.
CreateBatchInferenceJob
Genera consigli in batch sulla base di un elenco di elementi o utenti archiviati in Amazon S3 ed esporta i consigli in un bucket Amazon S3.
Per generare consigli sui batch, specifica l'ARN di una versione della soluzione e un URI Amazon S3 per i dati di input e output. Per la personalizzazione degli utenti, gli elementi più diffusi e le soluzioni di classificazione personalizzate, il processo di inferenza in batch genera un elenco di elementi consigliati per ogni ID utente nel file di input. Per le soluzioni relative agli articoli correlati, il job genera un elenco di elementi consigliati per ogni ID di elemento nel file di input.
Per ulteriori informazioni, vedere Creazione di un processo di inferenza in batch.
Se utilizzi la ricetta Similar-Items, Amazon Personalize può aggiungere temi descrittivi ai consigli in batch. Per generare temi, imposta la modalità del processo su THEME_GENERATION e specifica il nome del campo che contiene i nomi degli elementi nei dati di input.
Per ulteriori informazioni sulla generazione di temi, consulta i consigli in Batch con temi di Content Generator.
Non puoi ottenere consigli in batch con le ricette Trending-Now o Next-Best-Action.
Sintassi della richiesta
{
"batchInferenceJobConfig": {
"itemExplorationConfig": {
"string" : "string"
}
},
"batchInferenceJobMode": "string",
"filterArn": "string",
"jobInput": {
"s3DataSource": {
"kmsKeyArn": "string",
"path": "string"
}
},
"jobName": "string",
"jobOutput": {
"s3DataDestination": {
"kmsKeyArn": "string",
"path": "string"
}
},
"numResults": number,
"roleArn": "string",
"solutionVersionArn": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
],
"themeGenerationConfig": {
"fieldsForThemeGeneration": {
"itemName": "string"
}
}
}Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- batchInferenceJobConfig
-
I dettagli di configurazione di un processo di inferenza in batch.
Tipo: oggetto BatchInferenceJobConfig
Campo obbligatorio: no
- batchInferenceJobMode
-
La modalità del processo di inferenza in batch. Per generare temi descrittivi per gruppi di elementi simili, imposta la modalità di lavoro su.
THEME_GENERATIONSe non desideri generare temi, utilizza l'impostazione predefinitaBATCH_INFERENCE.Quando ricevi consigli in batch con temi, dovrai sostenere costi aggiuntivi. Per ulteriori informazioni, consulta i prezzi di Amazon Personalize
. ▬Tipo: stringa
Valori validi:
BATCH_INFERENCE | THEME_GENERATIONCampo obbligatorio: no
- filterArn
-
L'ARN del filtro da applicare al processo di inferenza batch. Per ulteriori informazioni sull'utilizzo dei filtri, vedere Suggerimenti per il filtraggio dei batch.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+Campo obbligatorio: no
- jobInput
-
Il percorso Amazon S3 che porta al file di input su cui basare i tuoi consigli. Il materiale di input deve essere in formato JSON.
Tipo: oggetto BatchInferenceJobInput
Campo obbligatorio: sì
- jobName
-
Il nome del processo di inferenza batch da creare.
▬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 verrà archiviato l'output del processo.
Tipo: oggetto BatchInferenceJobOutput
Campo obbligatorio: sì
- numResults
-
Il numero di consigli da recuperare.
Tipo: integer
Campo obbligatorio: no
- roleArn
-
L'ARN del ruolo Amazon Identity and Access Management che dispone delle autorizzazioni di lettura e scrittura rispettivamente nei bucket Amazon S3 di input e 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ì
- solutionVersionArn
-
L'Amazon Resource Name (ARN) della versione della soluzione che verrà utilizzata per generare i consigli di inferenza in batch.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+Campo obbligatorio: sì
-
Un elenco di tag da applicare al processo di inferenza in batch.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
Campo obbligatorio: no
- themeGenerationConfig
-
Per i lavori di generazione di temi, specifica il nome della colonna nel set di dati Items che contiene il nome di ogni elemento.
Tipo: oggetto ThemeGenerationConfig
Campo obbligatorio: no
Sintassi della risposta
{
"batchInferenceJobArn": "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.
- batchInferenceJobArn
-
L'ARN del processo di inferenza in batch.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+
Errori
- InvalidInputException
-
Fornite 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:
