本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
CreateEventTracker
创建事件跟踪器,在将事件数据添加到指定的数据集组时使用PutEventsAPI。
只有一个事件跟踪程序可以与数据集组关联。如果您使用相同的数据集组作为现有事件跟踪程序来调用 CreateEventTracker
,将收到错误。
当您创建事件跟踪器时,响应包含跟踪 ID,当您使用PutEventsoperation. 然后,Amazon Personalize 会将事件数据附加到您在事件跟踪器中指定的数据集组的互动数据集中。
事件跟踪器可以处于以下某种状态:
-
创建待处理 > 创建进度 > 活动-或-创建失败
-
删除待处理 > 删除正在进行
要获取事件跟踪器的状态,请致电描述 CribeEventTracker.
使用跟踪 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:.*:.*:.+
- trackingId
-
事件跟踪器的 ID。将此 ID 包含在向PutEventsAPI。
类型: 字符串
约束:长度上限为 256。
错误
- InvalidInputException
-
为字段或参数提供有效值。
HTTP 状态代码:400
- LimitExceededException
-
已超出每秒请求数的限制。
HTTP 状态代码:400
- ResourceAlreadyExistsException
-
已存在指定的资源。
HTTP 状态代码:400
- ResourceInUseException
-
正在使用指定的资源。
HTTP 状态代码:400
- ResourceNotFoundException
-
找不到指定的资源。
HTTP 状态代码:400
另请参阅
有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: