本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # CreateCampaign **重要** 当市场活动处于活动状态时，会产生市场活动费用。为避免产生不必要的费用，请务必在市场活动结束后删除它。有关市场活动成本的信息，请参阅 [Amazon Personalize 定价](https://aws.amazon.com/personalize/pricing/)。 创建可部署解决方案版本的市场活动。当客户调用[GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)和时 [GetPersonalizedRanking](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetPersonalizedRanking.html) APIs，会在请求中指定一个活动。 **最低预调配 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 定价](https://aws.amazon.com/personalize/pricing/)。 **状态** 市场活动可处于以下几种状态之一： + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE - 或 - CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS 要获取活动状态，请致电[DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html)。 **注意** 等到市场活动的 `status` 为 `ACTIVE` 时，再向市场活动询问建议。 **相关 APIs** + [ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html) + [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) + [UpdateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateCampaign.html) + [DeleteCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteCampaign.html) ## 请求语法 ``` { "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number }, "syncWithLatestSolutionVersion": boolean }, "minProvisionedTPS": number, "name": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## 请求参数 请求接受采用 JSON 格式的以下数据。 ** [campaignConfig](#API_CreateCampaign_RequestSyntax) ** 市场活动的配置详情。 类型：[CampaignConfig](API_CampaignConfig.md) 对象 必需：否 ** [minProvisionedTPS](#API_CreateCampaign_RequestSyntax) ** 指定 Amazon Personalize 将支持的请求的最低预调配每秒事务数（建议）。高 `minProvisionedTPS` 会增加您的账单费用。我们建议从 1 开始设置 `minProvisionedTPS`（默认值）。使用 Amazon CloudWatch 指标跟踪您的使用情况，并在必要`minProvisionedTPS`时增加使用量。 类型：整数 有效范围：最小值为 1。 必需：否 ** [name](#API_CreateCampaign_RequestSyntax) ** 新市场活动的名称。市场活动名称在您的账户内必须是唯一的。 类型：字符串 长度限制：最小长度为 1。最大长度为 63。 模式：`^[a-zA-Z0-9][a-zA-Z0-9\-_]*` 是否必需：是 ** [solutionVersionArn](#API_CreateCampaign_RequestSyntax) ** 用于与市场活动一起部署的已训练模型的 Amazon 资源名称（ARN）。要指定解决方案的最新解决方案版本，请以 `SolutionArn/$LATEST` 格式指定*解决方案*的 ARN。如果`True`在中设置为`syncWithLatestSolutionVersion`，则必须使用此格式[CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html)。 如果要部署的模型不是解决方案的最新解决方案版本，请指定解决方案版本的 ARN。 有关自动市场活动更新的更多信息，请参阅[启用自动市场活动更新](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update)。 类型：字符串 长度约束：最大长度为 256。 模式：`arn:([a-z\d-]+):personalize:.*:.*:.+` 是否必需：是 ** [tags](#API_CreateCampaign_RequestSyntax) ** 要应用于市场活动的[标签](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html)列表。 类型：[Tag](API_Tag.md) 对象数组 数组成员：最少 0 个物品。最多 200 项。 必需：否 ## 响应语法 ``` { "campaignArn": "string" } ``` ## 响应元素 如果此操作成功，则该服务将会发送回 HTTP 200 响应。 服务以 JSON 格式返回以下数据。 ** [campaignArn](#API_CreateCampaign_ResponseSyntax) ** 市场活动的 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 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateCampaign) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateCampaign) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateCampaign) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateCampaign) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateCampaign) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateCampaign) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateCampaign) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateCampaign) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateCampaign) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateCampaign)