本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateEventTracker
创建在将事件数据添加到指定数据集组时使用的事件跟踪器PutEventsAPI。
只有一个事件跟踪程序可以与数据集组关联。如果您使用相同的数据集组作为现有事件跟踪程序来调用 CreateEventTracker，将收到错误。
当您创建事件跟踪器时，响应会包含一个跟踪 ID，当您使用PutEventsoperation. 然后，Amazon Personalize 会将事件数据附加到您在事件跟踪器中指定的数据集组的 “互动” 数据集中。
事件跟踪器可以处于以下状态之一：
-
“创建挂起” > “正在创建” > “活动” 或 “创建失败”
-
删除挂起 > 删除正在进行中
要获取事件跟踪器的状态，请调用DescribeEventTracker。
使用跟踪 ID 之前，事件跟踪器必须处于 ACTIVE 状态。
请求语法
{
"datasetGroupArn": "string",
"name": "string"
}请求参数
请求接受采用 JSON 格式的以下数据。
- DatasetGroupArn
-
接收事件数据集组的 Amazon 资源名称 (ARN)。
类型: 字符串
长度约束：长度上限为 256。
模式：
arn:([a-z\d-]+):personalize:.*:.*:.+：必需 是
- name
-
事件跟踪器的名称。
类型: 字符串
长度约束：最小长度为 1。长度上限为 63。
模式：
^[a-zA-Z0-9][a-zA-Z0-9\-_]*：必需 是
响应语法
{
"eventTrackerArn": "string",
"trackingId": "string"
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回的以下数据。
- EventTrackerArn
-
事件跟踪器的 ARN。
类型: 字符串
长度约束：长度上限为 256。
模式：
arn:([a-z\d-]+):personalize:.*:.*:.+ - TrackId
-
事件跟踪器的 ID。将此 ID 包含在PutEventsAPI。
类型: 字符串
长度约束：长度上限为 256。
Errors
- InvalidInputException
-
为字段或参数提供有效值。
HTTP 状态代码：HTTP：HTTP：400
- LimitExceededException
-
每秒的请求数限制已超出。
HTTP 状态代码：HTTP：HTTP：400
- ResourceAlreadyExistsException
-
已存在指定的资源。
HTTP 状态代码：HTTP：HTTP：400
- ResourceInUseException
-
Specify resource is use (指定的资源正在使用
HTTP 状态代码：HTTP：HTTP：400
- ResourceNotFoundException
-
找不到指定的资源。
HTTP 状态代码：HTTP：HTTP：400