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
Während der Kampagne fallen Ihnen Kampagnenkosten an. 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-Preise
Erstellt eine Kampagne, die eine Lösungsversion bereitstellt. Wenn ein Kunde die GetPersonalizedRanking APIs GetRecommendations und aufruft, wird in der Anfrage eine Kampagne angegeben.
Mindestens bereitgestellte TPS und Auto-Scaling
Wichtig
Ein Hoch erhöht minProvisionedTPS Ihre Kosten. Wir empfehlen, mit 1 für zu beginnen minProvisionedTPS (Standardeinstellung). Verfolgen Sie Ihre Nutzung mithilfe von CloudWatch Amazon-Metriken und erhöhen Sie minProvisionedTPS diese bei Bedarf.
Wenn Sie eine Amazon Personalize-Kampagne erstellen, können Sie die Mindestanzahl der 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 GetPersonalizedRanking ODER-Anfrage. Die Standardeinstellung minProvisionedTPS ist 1.
Wenn Ihr TPS über den Wert steigtminProvisionedTPS, 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 zu den zurückminProvisionedTPS.
Ihnen wird das bereitgestellte Mindest-TPS oder, falls Ihre Anfragen das TPS überschreitenminProvisionedTPS, das tatsächliche TPS in Rechnung gestellt. Das tatsächliche TPS ist die Gesamtzahl der von Ihnen gestellten Empfehlungsanfragen. Wir empfehlen, mit einem niedrigen Wert zu beginnenminProvisionedTPS, Ihre Nutzung anhand von CloudWatch Amazon-Metriken zu verfolgen und den Wert dann nach minProvisionedTPS Bedarf zu erhöhen.
Weitere Informationen zu den Kampagnenkosten finden Sie unter Amazon Personalize-Preise
Status
Eine Kampagne kann sich in einem der folgenden Bundesstaaten befinden:
-
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -oder- CREATE FAILED
-
DELETE PENDING > DELETE IN_PROGRESS
Rufen Sie an, um den Kampagnenstatus zu erfahren DescribeCampaign.
Anmerkung
Warten Sie, bis status die Kampagne abgeschlossen ist, ACTIVE bevor Sie die Kampagne um Empfehlungen bitten.
Verbundene APIs
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
-
Die Konfigurationsdetails einer Kampagne.
Typ: CampaignConfig Objekt
Erforderlich: Nein
- minProvisionedTPS
-
Gibt die angeforderte Mindestanzahl an bereitgestellten Transaktionen (Empfehlungen) pro Sekunde an, die Amazon Personalize unterstützt. Ein Hoch erhöht
minProvisionedTPSIhre Rechnung. Wir empfehlen, mit 1 für zu beginnenminProvisionedTPS(die Standardeinstellung). Verfolgen Sie Ihre Nutzung mithilfe von CloudWatch Amazon-Metriken und erhöhen SieminProvisionedTPSdiese bei Bedarf.Typ: Ganzzahl
Gültiger Bereich: Mindestwert 1.
Erforderlich: Nein
- name
-
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
-
Der Amazon-Ressourcenname (ARN) des trainierten Modells, das zusammen mit der Kampagne eingesetzt werden soll. Um die neueste Lösungsversion Ihrer Lösung anzugeben, geben Sie den ARN Ihrer Lösung im
SolutionArn/$LATESTFormat an. Sie müssen dieses Format verwenden, wenn SiesyncWithLatestSolutionVersionesTruein der festlegen CampaignConfig.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 Kampagnenupdates finden Sie unter Automatische Kampagnenupdates aktivieren.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern:
arn:([a-z\d-]+):personalize:.*:.*:.+Erforderlich: Ja
-
Eine Liste von Stichwörtern, die auf die Kampagne angewendet werden sollen.
Typ: Array von Tag-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
-
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 einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: