CreateEventTracker - Amazon Personalize
请求语法请求参数响应语法响应元素错误另请参阅

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

CreateEventTracker

创建事件跟踪器，供您在使用 PutEventsAPI 向指定数据集组添加事件数据时使用。

注意

只有一个事件跟踪程序可以与数据集组关联。如果您使用相同的数据集组作为现有事件跟踪程序来调用 CreateEventTracker，将收到错误。

创建事件跟踪器时，响应中包含跟踪 ID，您在使用PutEvents操作时将其作为参数传递。然后，Amazon Personalize 会将事件数据附加到您在事件跟踪器中指定的数据集组的物品交互数据集中。

事件跟踪器可以处于以下某种状态：

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE - 或 - CREATE FAILED

  • DELETE PENDING > DELETE IN_PROGRESS

要获取事件跟踪器的状态，请致电DescribeEventTracker。

注意

在使用跟踪 ID 之前，事件跟踪器必须处于 ACTIVE 状态。

相关 API

请求语法

{
   "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\-_]*

必需：是

tags

要应用于事件跟踪器的标签列表。

类型：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

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：