As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# CreateEventTracker
Cria um rastreador de eventos que você usa ao adicionar dados de eventos a um grupo de conjuntos de dados especificado usando a [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)API.
**nota**
Somente um rastreador de eventos pode ser associado a um grupo de conjuntos de dados. Você receberá um erro se chamar `CreateEventTracker` usando o mesmo grupo de conjuntos de dados de um rastreador de eventos existente.
Quando você cria um rastreador de eventos, a resposta inclui uma ID de acompanhamento, que você passa como parâmetro ao usar a [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)operação. Depois, o Amazon Personalize anexará os dados de eventos ao conjunto de dados de interações com itens do grupo de conjuntos de dados que você especificar no rastreador de eventos.
O rastreador de eventos pode estar em um dos seguintes estados:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
Para obter o status do rastreador de eventos, ligue [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html).
**nota**
O rastreador de eventos deve estar no estado ATIVO antes de usar o ID de rastreamento.
**Relacionado 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)
## Sintaxe da solicitação
```
{
"datasetGroupArn": "string",
"name": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}
```
## Parâmetros da solicitação
A solicitação aceita os dados a seguir no formato JSON.
** [datasetGroupArn](#API_CreateEventTracker_RequestSyntax) **
O nome do recurso da Amazon (ARN) do conjunto de dados que recebe os dados de eventos.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão: `arn:([a-z\d-]+):personalize:.*:.*:.+`
Obrigatório: Sim
** [name](#API_CreateEventTracker_RequestSyntax) **
O nome do rastreador de eventos.
Tipo: string
Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63.
Padrão: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`
Obrigatório: Sim
** [tags](#API_CreateEventTracker_RequestSyntax) **
Uma lista de [tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) a serem aplicadas ao rastreador de eventos.
Tipo: matriz de objetos [Tag](API_Tag.md)
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.
Obrigatório: não
## Sintaxe da resposta
```
{
"eventTrackerArn": "string",
"trackingId": "string"
}
```
## Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
** [eventTrackerArn](#API_CreateEventTracker_ResponseSyntax) **
O ARN do rastreador de eventos.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
Padrão: `arn:([a-z\d-]+):personalize:.*:.*:.+`
** [trackingId](#API_CreateEventTracker_ResponseSyntax) **
O ID do rastreador de eventos. Inclua esse ID nas solicitações para a [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)API.
Tipo: string
Restrições de tamanho: o tamanho máximo é 256.
## Erros
** InvalidInputException **
Forneça um valor válido para o campo ou parâmetro.
Código de status HTTP: 400
** LimitExceededException **
O limite de número de solicitações por segundo foi excedido.
Código de status HTTP: 400
** ResourceAlreadyExistsException **
O recurso especificado já existe.
Código de status HTTP: 400
** ResourceInUseException **
O recurso especificado está em uso.
Código de status HTTP: 400
** ResourceNotFoundException **
Não foi possível encontrar o recurso especificado.
Código de status HTTP: 400
** TooManyTagsException **
Você excedeu o número máximo de tags que pode aplicar a esse recurso.
Código de Status HTTP: 400
## Consulte também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+ [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateEventTracker)