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 articoli o utenti archiviati in Amazon S3 ed esporta i consigli in un bucket Amazon S3.
Per generare consigli in 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 articoli più richiesti 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 elementi 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 Similar-Items ricetta, Amazon Personalize può aggiungere temi descrittivi ai consigli sui batch. Per generare temi, imposta la modalità del lavoro 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 Raccomandazioni in batch con temi di Content Generator.
Non puoi ottenere consigli in batch con le Next-Best-Action ricette Trending-Now o.
Sintassi della richiesta
{
"batchInferenceJobConfig": {
"itemExplorationConfig": {
"string" : "string"
},
"rankingInfluence": {
"string" : number
}
},
"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
Obbligatorio: no
- batchInferenceJobMode
-
La modalità del processo di inferenza in batch. Per generare temi descrittivi per gruppi di elementi simili, imposta la modalità lavoro su.
THEME_GENERATIONSe non vuoi generare temi, usa l'impostazione predefinita.BATCH_INFERENCEQuando 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 in batch. Per ulteriori informazioni sull'uso dei filtri, consulta Suggerimenti per il filtraggio dei batch.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+Obbligatorio: no
- jobInput
-
Il percorso di 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
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\-_]*Obbligatorio: sì
- jobOutput
-
Il percorso del bucket Amazon S3 in cui verrà archiviato l'output del lavoro.
Tipo: oggetto BatchInferenceJobOutput
Obbligatorio: sì
- numResults
-
Il numero di consigli da recuperare.
Tipo: Integer
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+=,.@\-_/]+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:.*:.*:.+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.
Obbligatorio: no
- themeGenerationConfig
-
Per i lavori di generazione di temi, specificate il nome della colonna nel set di dati Items che contiene il nome di ogni elemento.
Tipo: oggetto ThemeGenerationConfig
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
-
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:
