CreateCampaign - Amazon Personalize
请求语法请求参数响应语法响应元素错误另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

CreateCampaign

重要

在广告活动处于活动状态时，您需要支付广告费用。为避免不必要的费用，请务必在活动结束后删除该活动。有关活动费用的信息，请参阅 Amazon Personalize 定价。

创建可部署解决方案版本的市场活动。当客户调用GetRecommendations和 GetPersonalizedRankingAPI 时，会在请求中指定一个活动。

最低预调配 TPS 和自动扩缩

重要

高 minProvisionedTPS 会增加您的成本。我们建议从 1 开始设置 minProvisionedTPS（默认值）。使用 Amazon CloudWatch 指标跟踪您的使用情况，并在必要minProvisionedTPS时增加使用量。

在创建 Amazon Personalize 市场活动时，您可以为该市场活动指定预置的每秒最低事务数 (minProvisionedTPS)。这是 Amazon Personalize 为该市场活动预置的基准事务吞吐量。它会设置市场活动处于活动状态时的最低账单费用。事务是单个 GetRecommendations 或 GetPersonalizedRanking 请求。默认 minProvisionedTPS 为 1。

如果您的 TPS 增加到超过 minProvisionedTPS，则 Amazon Personalize 会自动纵向扩展和缩减预置容量，但从不会低于 minProvisionedTPS。增加容量时会有短时间延迟，这可能会导致事务丢失。当您的流量减少时，容量将恢复到 minProvisionedTPS。

您需要为预置的最低 TPS 付费，或者，如果您的请求超过 minProvisionedTPS，则需要为实际 TPS 付费。实际 TPS 是您发出的建议请求的总数。我们建议从低开始minProvisionedTPS，使用 Amazon CloudWatch 指标跟踪您的使用情况，然后minProvisionedTPS根据需要增加使用量。

有关市场活动成本的更多信息，请参阅 Amazon Personalize 定价。

状态

市场活动可处于以下几种状态之一：

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

  • DELETE PENDING > DELETE IN_PROGRESS

要获取活动状态，请致电DescribeCampaign。

注意

等到市场活动的 status 为 ACTIVE 时，再向市场活动询问建议。

相关 API

请求语法

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

请求参数

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

campaignConfig

市场活动的配置详情。

类型：CampaignConfig 对象

必需：否

minProvisionedTPS

指定 Amazon Personalize 将支持的请求的最低预调配每秒事务数（建议）。高 minProvisionedTPS 会增加您的账单费用。我们建议从 1 开始设置 minProvisionedTPS（默认值）。使用 Amazon CloudWatch 指标跟踪您的使用情况，并在必要minProvisionedTPS时增加使用量。

类型：整数

有效范围：最小值为 1。

必需：否

name

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

类型：字符串

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

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

必需：是

solutionVersionArn

要在活动中部署的训练模型的 Amazon 资源名称 (ARN)。要指定解决方案的最新解决方案版本，请按格式指定解决方案的 ARN。SolutionArn/$LATEST如果True在中设置为syncWithLatestSolutionVersion，则必须使用此格式CampaignConfig。

要部署不是解决方案最新解决方案版本的模型，请指定解决方案版本的 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 SDK 中使用此 API 的更多信息，请参阅以下内容：