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à.

# CreateBatchSegmentJob
<a name="API_CreateBatchSegmentJob"></a>

Crea un processo di segmentazione in batch. L'operazione può gestire fino a 50 milioni di record e il file di input deve essere in formato JSON. Per ulteriori informazioni, consulta [Ottenere consigli sui batch e segmenti di utenti](https://docs.aws.amazon.com/personalize/latest/dg/recommendations-batch.html).

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

```
{
   "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"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_CreateBatchSegmentJob_RequestParameters"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [filterArn](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-filterArn"></a>
L'ARN del filtro da applicare al processo del segmento 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_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-jobInput"></a>
Il percorso Amazon S3 per i dati di input utilizzati per generare il processo di segmentazione in batch.  
Tipo: oggetto [BatchSegmentJobInput](API_BatchSegmentJobInput.md)  
Obbligatorio: sì

 ** [jobName](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-jobName"></a>
Il nome del processo di segmento 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_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-jobOutput"></a>
Il percorso Amazon S3 per il bucket in cui verrà archiviato l'output del processo.  
Tipo: oggetto [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md)  
Obbligatorio: sì

 ** [numResults](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-numResults"></a>
Il numero di utenti previsti generato dal processo di segmentazione in batch per ogni riga di dati di input. Il numero massimo di utenti per segmento è di 5 milioni.  
Tipo: Integer  
Obbligatorio: no

 ** [roleArn](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-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_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-solutionVersionArn"></a>
L'Amazon Resource Name (ARN) della versione della soluzione che desideri venga utilizzato dal processo di segmentazione batch per generare segmenti batch.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [tags](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-tags"></a>
Un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare al processo di segmentazione 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

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

```
{
   "batchSegmentJobArn": "string"
}
```

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

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

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

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

## Errori
<a name="API_CreateBatchSegmentJob_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_CreateBatchSegmentJob_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/CreateBatchSegmentJob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchSegmentJob)