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

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

CreateCampaign

创建部署解决方案版本的活动。当客户呼叫GetRecommendations获取个性化排名API,请求中指定了一个广告活动。

最低预配置的 TPS 和自动扩展

一笔交易是单一的GetRecommendations要么GetPersonalizedRanking调用。每秒事务数 (TPS) 是 Amazon Personalize 的吞吐量和计费单位。最低预配置的 TPS (minProvisionedTPS) 指定 Amazon Personalize 化预配的基准吞吐量,从而指定最低账单费用。

如果你的 TPS 增加超过minProvisionedTPS,Amazon Personalize 化自动扩展预配置容量,但永远不会低于minProvisionedTPS. 容量增加时会有很短的延迟,这可能会导致交易丢失。

使用的实际 TPS 是按 5 分钟窗口内的平均请求/秒计算的。您为最低预配置的 TPS 或实际的 TPS 支付最高费用。我们建议从低开始minProvisionedTPS中,使用亚马逊跟踪您的使用 CloudWatch 指标,然后增加minProvisionedTPS根据需要。

状态

活动可以处于以下某种状态:

  • 创建待处理 > 创建进度 > 活动-或-创建失败

  • 删除待处理 > 删除正在进行

要获取广告活动状态,请致电描述广告活动.

注意

等到status活动的ACTIVE在向广告活动提出建议之前。

请求语法

{ "campaignConfig": { "itemExplorationConfig": { "string" : "string" } }, "minProvisionedTPS": number, "name": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] }

请求参数

请求接受采用 JSON 格式的以下数据。

campaignConfig

广告活动的配置详细信息。

类型:CampaignConfig 对象

:必需 否

minProvisionedTPS

指定 Amazon Personalize 将支持的每秒最小预配置交易数(建议)。

类型: 整数

有效范围:最小值为 1。

:必需 否

name

新活动的名称。活动名称在您的账户内必须是唯一的。

类型: 字符串

长度约束:最小长度为 1。长度上限为 63。

模式:^[a-zA-Z0-9][a-zA-Z0-9\-_]*

:必需 是

solutionVersionArn

要部署的解决方案版本的 Amazon 资源名称 (ARN)。

类型: 字符串

长度约束:长度上限为 256。

模式:arn:([a-z\d-]+):personalize:.*:.*:.+

:必需 是

tags

列表标签以申请广告活动。

类型: 数组Tag对象

数组成员:最少 0 项。最多 200 项。

:必需 否

响应语法

{ "campaignArn": "string" }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回的以下数据。

campaignArn

活动的 Amazon 资源名称 (ARN)。

类型: 字符串

长度约束:长度上限为 256。

模式:arn:([a-z\d-]+):personalize:.*:.*:.+

错误

InvalidInputException

为字段或参数提供有效值。

HTTP 状态代码:400

LimitExceededException

已超出每秒请求数的限制。

HTTP 状态代码:400

ResourceAlreadyExistsException

指定的资源已存在。

HTTP 状态代码:400

ResourceInUseException

指定的资源正在使用中。

HTTP 状态代码:400

ResourceNotFoundException

找不到指定的资源。

HTTP 状态代码:400

TooManyTagsException

您已超出您可以应用于此资源的最大标签数量。

HTTP 状态代码:400

另请参阅

有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: