CreateEventTracker - Amazon Personalize
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

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