本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateEventTracker
创建事件跟踪器，供您在使用 PutEventsAPI 向指定数据集组添加事件数据时使用。
注意
只有一个事件跟踪程序可以与数据集组关联。如果您使用相同的数据集组作为现有事件跟踪程序来调用 CreateEventTracker，将收到错误。
创建事件跟踪器时，响应中包含一个跟踪 ID，您在使用该PutEvents操作时将其作为参数传递。然后，Amazon Personalize 会将事件数据附加到您在事件跟踪器中指定的数据集组的物品交互数据集中。
事件跟踪器可以处于以下某种状态：
-
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE - 或 - CREATE FAILED
-
DELETE PENDING > DELETE IN_PROGRESS
要获取事件跟踪器的状态，请致电DescribeEventTracker。
注意
在使用跟踪 ID 之前，事件跟踪器必须处于 ACTIVE 状态。
请求语法
{
"datasetGroupArn": "string",
"name": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}请求参数
请求接受采用 JSON 格式的以下数据。
- datasetGroupArn
-
接收事件数据的数据集组的 Amazon 资源名称 (ARN)。
类型：字符串
长度约束：最大长度为 256。
模式：
arn:([a-z\d-]+):personalize:.*:.*:.+必需：是
- name
-
事件跟踪器的名称。
类型：字符串
长度限制：最小长度为 1。最大长度为 63。
模式：
^[a-zA-Z0-9][a-zA-Z0-9\-_]*必需：是
-
要应用于事件跟踪器的标签列表。
类型：Tag 对象数组
数组成员：最少 0 个物品。最多 200 项。
必需：否
响应语法
{
"eventTrackerArn": "string",
"trackingId": "string"
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- eventTrackerArn
-
事件跟踪器的 ARN。
类型：字符串
长度约束：最大长度为 256。
模式：
arn:([a-z\d-]+):personalize:.*:.*:.+ - trackingId
-
事件跟踪器的 ID。在向 PutEventsAPI 发出的请求中包含此 ID。
类型：字符串
长度约束：最大长度为 256。
错误
- InvalidInputException
-
为字段或参数提供有效值。
HTTP 状态代码：400
- LimitExceededException
-
超出每秒请求次数的限制。
HTTP 状态代码：400
- ResourceAlreadyExistsException
-
指定资源已经存在。
HTTP 状态代码：400
- ResourceInUseException
-
指定的资源正在使用中。
HTTP 状态代码：400
- ResourceNotFoundException
-
找不到指定的资源。
HTTP 状态代码：400
- TooManyTagsException
-
您已超出您可以应用到此资源的最大标签数量。
HTTP 状态代码：400
另请参阅
有关以特定语言之一使用此 API 的更多信息 Amazon SDKs，请参阅以下内容：