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. # CreateCampaign **Wichtig** Es fallen Kampagnenkosten an, solange sie aktiv ist. Um unnötige Kosten zu vermeiden, stellen Sie sicher, dass Sie die Kampagne löschen, wenn Sie fertig sind. Informationen zu den Kampagnenkosten finden Sie unter [Amazon Personalize Personalize-Preise](https://aws.amazon.com/personalize/pricing/). Erstellt eine Kampagne, die eine Lösungsversion bereitstellt. Wenn ein Kunde das [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)und aufruft [GetPersonalizedRanking](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetPersonalizedRanking.html) APIs, wird in der Anfrage eine Kampagne angegeben. **Mindestens bereitgestelltes TPS und automatische Skalierung** **Wichtig** Ein Hoch erhöht `minProvisionedTPS` Ihre Kosten. 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. Wenn Sie eine Amazon Personalize Personalize-Kampagne erstellen, können Sie die Mindestanzahl an bereitgestellten Transaktionen pro Sekunde (`minProvisionedTPS`) für die Kampagne angeben. Dies ist der grundlegende Transaktionsdurchsatz für die von Amazon Personalize bereitgestellte Kampagne. Es legt die Mindestabrechnungsgebühr für die Kampagne fest, solange sie aktiv ist. Eine Transaktion ist eine einzelne `GetRecommendations` oder eine `GetPersonalizedRanking` Anfrage. Die Standardeinstellung `minProvisionedTPS` ist 1. Steigt Ihr TPS über den Wert hinaus`minProvisionedTPS`, skaliert Amazon Personalize die bereitgestellte Kapazität automatisch nach oben und unten, aber niemals darunter. `minProvisionedTPS` Bei der Erhöhung der Kapazität kommt es zu einer kurzen Zeitverzögerung, die zum Verlust von Transaktionen führen kann. Wenn Ihr Traffic abnimmt, kehrt die Kapazität auf die zurück`minProvisionedTPS`. Ihnen wird das bereitgestellte Mindest-TPS oder, falls Ihre Anfragen das TPS überschreiten`minProvisionedTPS`, das tatsächliche TPS in Rechnung gestellt. Der tatsächliche TPS ist die Gesamtzahl der von Ihnen gestellten Empfehlungsanfragen. Wir empfehlen, mit einem niedrigen Wert zu beginnen`minProvisionedTPS`, Ihre Nutzung anhand von CloudWatch Amazon-Metriken zu verfolgen und den Wert dann bei `minProvisionedTPS` Bedarf zu erhöhen. Weitere Informationen zu den Kampagnenkosten finden Sie unter [Amazon Personalize Personalize-Preise](https://aws.amazon.com/personalize/pricing/). **Status** Eine Kampagne kann sich in einem der folgenden Zustände befinden: + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oder- CREATE FAILED + DELETE PENDING > DELETE IN\$1PROGRESS Rufen Sie an, um den Kampagnenstatus zu erfahren [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html). **Anmerkung** Warten Sie, bis `status` die Kampagne gestartet ist, `ACTIVE` bevor Sie die Kampagne um Empfehlungen bitten. **Verwandt 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) ## Anforderungssyntax ``` { "campaignConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "rankingInfluence": { "string" : number }, "syncWithLatestSolutionVersion": boolean }, "minProvisionedTPS": number, "name": "string", "solutionVersionArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## Anforderungsparameter Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [campaignConfig](#API_CreateCampaign_RequestSyntax) ** Die Konfigurationsdetails einer Kampagne. Typ: [CampaignConfig](API_CampaignConfig.md) Objekt Erforderlich: Nein ** [minProvisionedTPS](#API_CreateCampaign_RequestSyntax) ** 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 ** [name](#API_CreateCampaign_RequestSyntax) ** Ein Name für die neue Kampagne. Der Kampagnenname muss in Ihrem Konto eindeutig sein. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 63 Zeichen. Pattern: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` Erforderlich: Ja ** [solutionVersionArn](#API_CreateCampaign_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) des trainierten Modells, das mit der Kampagne eingesetzt 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 einstellen [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: Ja ** [tags](#API_CreateCampaign_RequestSyntax) ** Eine Liste von [Tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html), die auf die Kampagne angewendet werden sollen. Typ: Array von [Tag](API_Tag.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente. Erforderlich: Nein ## Antwortsyntax ``` { "campaignArn": "string" } ``` ## Antwortelemente 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_CreateCampaign_ResponseSyntax) ** Der Amazon-Ressourcennamen (ARN) der Kampagne. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen. Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## Fehler ** InvalidInputException ** Geben Sie einen gültigen Wert für das Feld oder den Parameter an. HTTP-Statuscode: 400 ** LimitExceededException ** Das Limit für die Anzahl der Anfragen pro Sekunde wurde überschritten. HTTP-Statuscode: 400 ** ResourceAlreadyExistsException ** Die angegebene Ressource ist bereits vorhanden. HTTP-Statuscode: 400 ** ResourceInUseException ** Die angegebene Ressource wird verwendet. HTTP-Statuscode: 400 ** ResourceNotFoundException ** Die angegebene Ressource konnte nicht gefunden werden. HTTP-Statuscode: 400 ** TooManyTagsException ** Sie haben die maximale Anzahl von Tags überschritten, die Sie auf diese Ressource anwenden können. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: 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/CreateCampaign) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateCampaign) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateCampaign) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateCampaign) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateCampaign) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateCampaign) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateCampaign) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateCampaign) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateCampaign) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateCampaign)