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
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.
Sintassi della richiesta
{
"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
La richiesta accetta i seguenti dati in formato JSON.
- filterArn
-
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.
▬Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+Campo obbligatorio: no
- jobInput
-
Il percorso Amazon S3 per i dati di input utilizzati per generare il processo di segmentazione in batch.
Tipo: oggetto BatchSegmentJobInput
Campo obbligatorio: sì
- jobName
-
Il nome del processo di segmento 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 Amazon S3 per il bucket in cui verrà archiviato l'output del processo.
Tipo: oggetto BatchSegmentJobOutput
Campo obbligatorio: sì
- numResults
-
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
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 desideri venga utilizzato dal processo di segmentazione batch per generare segmenti 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 segmentazione in batch.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
Campo obbligatorio: no
Sintassi della risposta
{
"batchSegmentJobArn": "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.
- batchSegmentJobArn
-
L'ARN del processo di segmentazione 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:
