本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# UpdateCampaign
<a name="API_UpdateCampaign"></a>

 更新行銷活動以使用現有行銷活動部署重新訓練的解決方案版本、變更行銷活動的 `minProvisionedTPS`，或修改行銷活動的組態。例如，您可以將現有行銷活動的 `enableMetadataWithRecommendations` 設為 true。

 若要更新行銷活動以使用最新的解決方案版本自動啟動，請指定下列項目：
+ 針對 `SolutionVersionArn` 參數，以 `SolutionArn/$LATEST` 格式指定解決方案的 Amazon Resource Name (ARN)。
+  在 中`campaignConfig`，將 `syncWithLatestSolutionVersion` 設定為 `true`。

若要更新行銷活動，行銷活動狀態必須為 ACTIVE 或 CREATE FAILED。使用 [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) 操作檢查行銷活動狀態。

**注意**  
當更新正在進行時，您仍然可以從行銷活動取得建議。行銷活動將使用先前的解決方案版本和行銷活動組態來產生建議，直到最新的行銷活動更新狀態為 為止`Active`。

如需更新行銷活動的詳細資訊，包括程式碼範例，請參閱[更新行銷活動](https://docs.aws.amazon.com/personalize/latest/dg/update-campaigns.html)。如需行銷活動的詳細資訊，請參閱[建立行銷活動](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html)。

## 請求語法
<a name="API_UpdateCampaign_RequestSyntax"></a>

```
{
   "campaignArn": "string",
   "campaignConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "rankingInfluence": { 
         "string" : number 
      },
      "syncWithLatestSolutionVersion": boolean
   },
   "minProvisionedTPS": number,
   "solutionVersionArn": "string"
}
```

## 請求參數
<a name="API_UpdateCampaign_RequestParameters"></a>

請求接受採用 JSON 格式的下列資料。

 ** [campaignArn](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-campaignArn"></a>
行銷活動的 Amazon Resource Name (ARN)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：是

 ** [campaignConfig](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-campaignConfig"></a>
行銷活動的組態詳細資訊。  
類型：[CampaignConfig](API_CampaignConfig.md) 物件  
必要：否

 ** [minProvisionedTPS](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-minProvisionedTPS"></a>
指定 Amazon Personalize 將支援的每秒請求的最低佈建交易 （建議）。較高的 `minProvisionedTPS`會增加您的帳單。我們建議從 1 開始 `minProvisionedTPS`（預設值）。使用 Amazon CloudWatch 指標追蹤您的用量，並視需要增加 `minProvisionedTPS`。  
類型：整數  
有效範圍：最小值為 1。  
必要：否

 ** [solutionVersionArn](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-solutionVersionArn"></a>
要部署之新模型的 Amazon Resource Name (ARN)。若要指定解決方案的最新解決方案版本，請以 `SolutionArn/$LATEST` 格式指定*解決方案*的 ARN。如果您在 [CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html) `True`中`syncWithLatestSolutionVersion`將 設定為 ，則必須使用此格式。  
 若要部署不是解決方案最新版本的模型，請指定解決方案版本的 ARN。  
 如需自動行銷活動更新的詳細資訊，請參閱[啟用自動行銷活動更新](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update)。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`  
必要：否

## 回應語法
<a name="API_UpdateCampaign_ResponseSyntax"></a>

```
{
   "campaignArn": "string"
}
```

## 回應元素
<a name="API_UpdateCampaign_ResponseElements"></a>

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

 ** [campaignArn](#API_UpdateCampaign_ResponseSyntax) **   <a name="personalize-UpdateCampaign-response-campaignArn"></a>
與請求中指定的行銷活動 ARN 相同。  
類型：字串  
長度限制：長度上限為 256。  
模式：`arn:([a-z\d-]+):personalize:.*:.*:.+`

## 錯誤
<a name="API_UpdateCampaign_Errors"></a>

 ** InvalidInputException **   
提供欄位或參數的有效值。  
HTTP 狀態碼：400

 ** ResourceInUseException **   
指定的資源正在使用中。  
HTTP 狀態碼：400

 ** ResourceNotFoundException **   
找不到指定的資源。  
HTTP 狀態碼：400

## 另請參閱
<a name="API_UpdateCampaign_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateCampaign) 
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateCampaign) 
+  [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateCampaign) 
+  [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateCampaign)