View a markdown version of this page

CreateRecommender - Amazon Personalize

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.

CreateRecommender

Erstellt einen Empfehlungsgeber mit dem von Ihnen angegebenen Rezept (ein Anwendungsfall für Domain-Datensatzgruppen). Sie erstellen Empfehlungen für eine Domain-Datensatzgruppe und geben den Amazon-Ressourcennamen (ARN) des Empfehlenden an, wenn Sie eine Anfrage stellen. GetRecommendations

Mindestanzahl von Empfehlungsanfragen pro Sekunde

Wichtig

Ein minRecommendationRequestsPerSecond Höchstwert erhöht Ihre Rechnung. Wir empfehlen, mit 1 für zu beginnen minRecommendationRequestsPerSecond (die Standardeinstellung). Verfolgen Sie Ihre Nutzung mithilfe von CloudWatch Amazon-Metriken und erhöhen Sie minRecommendationRequestsPerSecond diese bei Bedarf.

Wenn Sie einen Empfehlungsgeber erstellen, können Sie die Mindestanzahl der Empfehlungsanfragen pro Sekunde konfigurieren. Die Mindestanzahl der Empfehlungsanfragen pro Sekunde (minRecommendationRequestsPerSecond) gibt den von Amazon Personalize bereitgestellten Basisdurchsatz für Empfehlungsanfragen an. Die Standardmindesteinstellung ist. RecommendationRequestsPerSecond 1 Eine Empfehlungsanfrage ist ein einzelner GetRecommendations Vorgang. Der Anforderungsdurchsatz wird in Anfragen pro Sekunde gemessen. Amazon Personalize verwendet Ihre Anfragen pro Sekunde, um Ihre Anfragen pro Stunde und den Preis für die Nutzung Ihrer Empfehlung abzuleiten.

Wenn Ihre Anfragen pro Sekunde darüber hinaus steigenminRecommendationRequestsPerSecond, skaliert Amazon Personalize die bereitgestellte Kapazität automatisch nach oben und unten, aber niemals darunter. minRecommendationRequestsPerSecond Bei der Erhöhung der Kapazität kommt es zu einer kurzen Zeitverzögerung, die zum Verlust von Anfragen führen kann.

Ihre Rechnung entspricht entweder der Mindestanzahl der Anfragen pro Stunde (basierend auf der MindestanzahlRecommendationRequestsPerSecond) oder der tatsächlichen Anzahl der Anfragen, je nachdem, welcher Betrag höher ist. Der tatsächlich verwendete Anforderungsdurchsatz wird als Durchschnitt requests/second innerhalb eines Zeitfensters von einer Stunde berechnet. Wir empfehlen, mit der Standardeinstellung zu beginnenminRecommendationRequestsPerSecond, Ihre Nutzung anhand von CloudWatch Amazon-Metriken zu verfolgen und diese dann nach minRecommendationRequestsPerSecond Bedarf zu erhöhen.

Status

Ein Empfehlungsgeber kann sich in einem der folgenden Bundesstaaten befinden:

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -oder- CREATE FAILED

  • AUSSTEHEND BEENDEN > IN_PROGRESS BEENDEN > INAKTIV > AUSSTEHEND STARTEN > IN_PROGRESS STARTEN > AKTIV

  • DELETE PENDING > DELETE IN_PROGRESS

Rufen Sie an, um den Empfehlungsstatus zu erhalten. DescribeRecommender

Anmerkung

Warten Sie, bis status der Empfehlungsgeber da ist, ACTIVE bevor Sie den Empfehlenden um Empfehlungen bitten.

Anforderungssyntax

{ "datasetGroupArn": "string", "name": "string", "recipeArn": "string", "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] }, "includedDatasetColumns": { "string" : [ "string" ] } } }, "tags": [ { "tagKey": "string", "tagValue": "string" } ] }

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

datasetGroupArn

Der Amazon-Ressourcenname (ARN) der Zieldomänen-Datensatzgruppe für den Empfehlenden.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.

Pattern: arn:([a-z\d-]+):personalize:.*:.*:.+

Erforderlich: Ja

name

Der Name des Empfehlenden.

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

recipeArn

Der Amazon-Ressourcenname (ARN) des Rezepts, das der Empfehlende verwenden wird. Für einen Empfehlungsgeber ist ein Rezept ein Anwendungsfall für eine Domain-Datensatzgruppe. Nur Anwendungsfälle für Domain-Datensatzgruppen können verwendet werden, um einen Empfehlungsgeber zu erstellen. Informationen zu Anwendungsfällen finden Sie unter Anwendungsfälle für Empfehlungen auswählen.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.

Pattern: arn:([a-z\d-]+):personalize:.*:.*:.+

Erforderlich: Ja

recommenderConfig

Die Konfigurationsdetails des Empfehlers.

Typ: RecommenderConfig Objekt

Erforderlich: Nein

tags

Eine Liste von Stichwörtern, die auf den Empfehlenden 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

{ "recommenderArn": "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.

recommenderArn

Der Amazon-Ressourcenname (ARN) des Empfehlenden.

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: