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

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

CreateCampaign

通过部署解决方案版本来创建市场活动。当客户端调用GetRecommendations获取个性化排名API,则在请求中指定市场活动。

最低预配置 TPS 和自动扩展

一个事务是一个GetRecommendations或者GetPersonalizedRanking调用。每秒交易数 (TPS) 是 Amazon Personalize 的吞吐量和计费单位。预配置的最低 TPS (minProvisionedTPS)指定 Amazon Personalize 预配置的基准吞吐量,以及最低账单费用。

如果您的 TPS 增长超过minProvisionedTPS,Amazon Personalize 可自动向上和向下扩展预配置容量,但永远不会低于minProvisionedTPS。容量增加时会有很短的时间延迟,这可能会导致事务丢失。

实际使用的 TPS 按 5 分钟窗口内的平均请求/秒计算。您需要支付最低预配置 TPS 或实际 TPS 的最大费用。我们建议从低minProvisionedTPS,使用 Amazon CloudWatch 指标跟踪您的使用情况,然后增加minProvisionedTPS视需要而定。

状态

广告活动可以处于以下状态之一:

  • “创建挂起” > “正在创建” > “活动” 或 “创建失败”

  • 删除挂起 > 删除正在进行

要获取广告活动状态,请调用DescribeCampaign

注意

等待,直到status活动的ACTIVE之前要求运动的建议。

请求语法

{ "campaignConfig": { "itemExplorationConfig": { "string" : "string" } }, "minProvisionedTPS": number, "name": "string", "solutionVersionArn": "string" }

请求参数

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

活动配置

市场活动的配置详细信息。

类型:CampaignConfig 对象

:必需 否

小规模供应商

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

类型: 整数

有效范围:最小值为 1。

:必需 是

name

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

类型: 字符串

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

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

:必需 是

SolutionVersionArn

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

类型: 字符串

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

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

:必需 是

响应语法

{ "campaignArn": "string" }

响应元素

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

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

CaspaignArn

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

类型: 字符串

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

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

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