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

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

CreateCampaign

创建部署解决方案版本的活动。当客户端调用GetRecommendationsGetPersonalizedRankingAPI 时,将在请求中指定活动。

最低预配置 TPS 和自动扩展

重要

高点minProvisionedTPS会增加你的账单。我们建议以 1 开头minProvisionedTPS(默认)。使用亚马逊 CloudWatch 指标跟踪您的使用情况,并在必要minProvisionedTPS时增加使用量。

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

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

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

状态

活动的可以处于以下几状态状态状态状态状态状态状态状态状态状态状态状态状态状态状态状态状态状态

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

  • DELETE PENDING > DELETE IN_PROGRESS

要获取活动状态,请致电DescribeCampaign

注意

等到竞选活动status结束ACTIVE后再向竞选活动征求建议。

请求语法

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

请求参数

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

campaignConfig

活动的配置详情,活动的配置细节,活动的配置详情。

类型:CampaignConfig 对象

必需:否

minProvisionedTPS

指定 Amazon Personalize 将支持的每秒请求的最低预置交易量(建议)。高点minProvisionedTPS会增加你的账单。我们建议以 1 开头minProvisionedTPS(默认)。使用亚马逊 CloudWatch 指标跟踪您的使用情况,并在必要minProvisionedTPS时增加使用量。

类型:整数

有效范围:最小值为 1。

必需:否

name

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

类型:字符串

长度限制:最小长度为 1。最大长度为 63。

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

必需:是

solutionVersionArn

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

类型:字符串

长度限制:最大长度为 256。

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

必需:是

tags

要应用于活动的活动的标签列表,列出要应用于活动的标签列表,列出活动的标签

类型:Tag 对象数组

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

必需:否

响应语法

{ "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

您已超过您可以应用于此资源的最多(Titiess)

HTTP 状态代码:400

另请参阅

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