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
<a name="API_CreateBatchInferenceJob"></a>

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](https://docs.aws.amazon.com/personalize/latest/dg/getting-batch-recommendations.html).

 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](https://docs.aws.amazon.com/personalize/latest/dg/themed-batch-recommendations.html). 

Non puoi ricevere consigli in batch con Trending-Now o con le ricette. Next-Best-Action

## Sintassi della richiesta
<a name="API_CreateBatchInferenceJob_RequestSyntax"></a>

```
{
   "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
<a name="API_CreateBatchInferenceJob_RequestParameters"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [batchInferenceJobConfig](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-batchInferenceJobConfig"></a>
I dettagli di configurazione di un processo di inferenza in batch.  
Tipo: oggetto [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md)  
Obbligatorio: no

 ** [batchInferenceJobMode](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-batchInferenceJobMode"></a>
La modalità del processo di inferenza in batch. Per generare temi descrittivi per gruppi di elementi simili, imposta la modalità di lavoro su. `THEME_GENERATION` Se non desideri generare temi, utilizza l'impostazione predefinita`BATCH_INFERENCE`.  
 Quando ricevi consigli in batch con temi, dovrai sostenere costi aggiuntivi. Per ulteriori informazioni, consulta i [prezzi di Amazon Personalize](https://aws.amazon.com/personalize/pricing/).   
Tipo: String  
Valori validi: `BATCH_INFERENCE | THEME_GENERATION`   
Campo obbligatorio: no

 ** [filterArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-filterArn"></a>
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.](https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html)  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [jobInput](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobInput"></a>
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](API_BatchInferenceJobInput.md)  
Obbligatorio: sì

 ** [jobName](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobName"></a>
Il nome del processo di inferenza batch da creare.  
Tipo: String  
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](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobOutput"></a>
Il percorso verso il bucket Amazon S3 in cui verrà archiviato l'output del processo.  
Tipo: oggetto [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md)  
Obbligatorio: sì

 ** [numResults](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-numResults"></a>
Il numero di consigli da recuperare.  
Tipo: Integer  
Obbligatorio: no

 ** [roleArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-roleArn"></a>
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: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obbligatorio: sì

 ** [solutionVersionArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-solutionVersionArn"></a>
L'Amazon Resource Name (ARN) della versione della soluzione che verrà utilizzata per generare i consigli di inferenza in batch.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [tags](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-tags"></a>
Un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare al processo di inferenza in batch.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Obbligatorio: no

 ** [themeGenerationConfig](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-themeGenerationConfig"></a>
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](API_ThemeGenerationConfig.md)  
Obbligatorio: no

## Sintassi della risposta
<a name="API_CreateBatchInferenceJob_ResponseSyntax"></a>

```
{
   "batchInferenceJobArn": "string"
}
```

## Elementi di risposta
<a name="API_CreateBatchInferenceJob_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [batchInferenceJobArn](#API_CreateBatchInferenceJob_ResponseSyntax) **   <a name="personalize-CreateBatchInferenceJob-response-batchInferenceJobArn"></a>
L'ARN del processo di inferenza in batch.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errori
<a name="API_CreateBatchInferenceJob_Errors"></a>

 ** 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
<a name="API_CreateBatchInferenceJob_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchInferenceJob)