本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
CreateCampaign
创建部署解决方案版本的活动。当客户端调用GetRecommendations和 GetPersonalizedRankingAPI 时,将在请求中指定活动。
最低预配置 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 的更多信息,请参阅以下内容: