

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

 Aktualisiert eine Kampagne, um eine neu trainierte Lösungsversion mit einer vorhandenen Kampagne bereitzustellen, die Ihrer Kampagne zu ändern oder die Konfiguration Ihrer Kampagne zu ändern. `minProvisionedTPS` Beispielsweise können Sie für eine bestehende Kampagne `enableMetadataWithRecommendations` den Wert auf „true“ setzen.

 Um eine Kampagne so zu aktualisieren, dass sie automatisch mit der neuesten Lösungsversion gestartet wird, geben Sie Folgendes an:
+ Geben Sie für den `SolutionVersionArn` Parameter den Amazon-Ressourcennamen (ARN) Ihrer Lösung im `SolutionArn/$LATEST` Format an. 
+  Stellen Sie im `campaignConfig` `syncWithLatestSolutionVersion` auf ein`true`. 

Um eine Kampagne zu aktualisieren, muss der Kampagnenstatus AKTIV oder CREATE FAILED lauten. Überprüfen Sie den Kampagnenstatus mithilfe der [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html)Operation.

**Anmerkung**  
Sie können immer noch Empfehlungen von einer Kampagne erhalten, während ein Update läuft. Die Kampagne verwendet die vorherige Lösungsversion und Kampagnenkonfiguration, um Empfehlungen zu generieren, bis der aktuelle Status der Kampagnenaktualisierung lautet`Active`. 

Weitere Informationen zum Aktualisieren einer Kampagne, einschließlich Codebeispielen, finden Sie unter [Kampagne aktualisieren](https://docs.aws.amazon.com/personalize/latest/dg/update-campaigns.html). Weitere Informationen zu Kampagnen finden Sie unter [Kampagne erstellen](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html).

## Anforderungssyntax
<a name="API_UpdateCampaign_RequestSyntax"></a>

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

## Anforderungsparameter
<a name="API_UpdateCampaign_RequestParameters"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [campaignArn](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-campaignArn"></a>
Der Amazon-Ressourcennamen (ARN) der Kampagne.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Ja

 ** [campaignConfig](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-campaignConfig"></a>
Die Konfigurationsdetails einer Kampagne.  
Typ: [CampaignConfig](API_CampaignConfig.md) Objekt  
Erforderlich: Nein

 ** [minProvisionedTPS](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-minProvisionedTPS"></a>
Gibt die angeforderte Mindestanzahl bereitgestellter Transaktionen (Empfehlungen) pro Sekunde an, die Amazon Personalize unterstützt. Ein Hoch erhöht `minProvisionedTPS` Ihre Rechnung. Wir empfehlen, mit 1 für zu beginnen `minProvisionedTPS` (Standard). Verfolgen Sie Ihre Nutzung anhand von CloudWatch Amazon-Metriken und erhöhen Sie `minProvisionedTPS` diese bei Bedarf.  
Typ: Ganzzahl  
Gültiger Bereich: Mindestwert 1.  
Erforderlich: Nein

 ** [solutionVersionArn](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-solutionVersionArn"></a>
Der Amazon-Ressourcenname (ARN) eines neuen Modells, das bereitgestellt werden soll. Um die neueste Lösungsversion Ihrer Lösung anzugeben, geben Sie den ARN Ihrer *Lösung* im `SolutionArn/$LATEST` Format an. Sie müssen dieses Format verwenden, wenn Sie `True` in der `syncWithLatestSolutionVersion` auf eingestellt haben [CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html).   
 Um ein Modell bereitzustellen, das nicht die neueste Lösungsversion Ihrer Lösung ist, geben Sie den ARN der Lösungsversion an.   
 Weitere Informationen zu automatischen Kampagnen-Updates finden Sie unter [Automatische Kampagnen-Updates aktivieren](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update).   
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Nein

## Antwortsyntax
<a name="API_UpdateCampaign_ResponseSyntax"></a>

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

## Antwortelemente
<a name="API_UpdateCampaign_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [campaignArn](#API_UpdateCampaign_ResponseSyntax) **   <a name="personalize-UpdateCampaign-response-campaignArn"></a>
Derselbe Kampagnen-ARN wie in der Anfrage angegeben.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Fehler
<a name="API_UpdateCampaign_Errors"></a>

 ** InvalidInputException **   
Geben Sie einen gültigen Wert für das Feld oder den Parameter an.  
HTTP-Statuscode: 400

 ** ResourceInUseException **   
Die angegebene Ressource wird verwendet.  
HTTP-Statuscode: 400

 ** ResourceNotFoundException **   
Die angegebene Ressource konnte nicht gefunden werden.  
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_UpdateCampaign_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateCampaign) 