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à.
# CreateEventTracker
Crea un tracker di eventi da utilizzare per aggiungere dati di eventi a un gruppo di set di dati specificato utilizzando l'[PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)API.
**Nota**
Solo un tracciatore di eventi può essere associato a un gruppo di set di dati. Verrà restituito un errore se `CreateEventTracker` viene chiamato usando il gruppo di set di dati come tracciatore di eventi esistente.
Quando si crea un tracker di eventi, la risposta include un ID di tracciamento, che viene passato come parametro quando si utilizza l'operazione. [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) Amazon Personalize aggiunge quindi i dati dell'evento al set di dati sulle interazioni tra oggetti del gruppo di set di dati specificato nel tracker degli eventi.
L'event tracker può trovarsi in uno dei seguenti stati:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oppure- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
Per conoscere lo stato dell'event tracker, chiama. [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html)
**Nota**
L'event tracker deve essere nello stato ATTIVO prima di utilizzare l'ID di tracciamento.
**Correlato APIs**
+ [ListEventTrackers](https://docs.aws.amazon.com/personalize/latest/dg/API_ListEventTrackers.html)
+ [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html)
+ [DeleteEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteEventTracker.html)
## Sintassi della richiesta
```
{
"datasetGroupArn": "string",
"name": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}
```
## Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [datasetGroupArn](#API_CreateEventTracker_RequestSyntax) **
L'Amazon Resource Name (ARN) del gruppo di set di dati che riceve i dati dell'evento.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 256.
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`
Obbligatorio: sì
** [name](#API_CreateEventTracker_RequestSyntax) **
Il nome dell'event tracker.
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ì
** [tags](#API_CreateEventTracker_RequestSyntax) **
Un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare all'event tracker.
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
```
{
"eventTrackerArn": "string",
"trackingId": "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.
** [eventTrackerArn](#API_CreateEventTracker_ResponseSyntax) **
L'ARN dell'event tracker.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 256.
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`
** [trackingId](#API_CreateEventTracker_ResponseSyntax) **
L'ID del tracker di eventi. Includi questo ID nelle richieste all'[PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)API.
Tipo: String
Limitazioni di lunghezza: lunghezza massima di 256.
## 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 **
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 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/CreateEventTracker)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateEventTracker)