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 PutEventsAPI.
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 PutEventsoperaçã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_PROGRESS > ACTIVE -or- CREATE FAILED
-
DELETE PENDING > DELETE IN_PROGRESS
Para obter o status do rastreador de eventos, ligue DescribeEventTracker.
nota
O rastreador de eventos deve estar no estado ATIVO antes de usar o ID de rastreamento.
APIs relacionadas
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
-
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:.*:.*:.+Exigido: Sim
- name
-
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\-_]*Exigido: Sim
-
Uma lista de tags a serem aplicadas ao rastreador de eventos.
Tipo: matriz de objetos Tag
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 tiver êxito, o serviço enviará de volta uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- eventTrackerArn
-
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
-
O ID do rastreador de eventos. Inclua esse ID nas solicitações para a PutEventsAPI.
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 um dos AWS SDKs específicos da linguagem, consulte o seguinte:
