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 eine Empfehlung 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 Empfehlungsgebers an, wenn Sie eine [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)Anfrage stellen. **Minimale Anzahl von Empfehlungsanfragen pro Sekunde** **Wichtig** Ein Hoch `minRecommendationRequestsPerSecond` erhöht Ihre Rechnung. Wir empfehlen, mit 1 für zu beginnen `minRecommendationRequestsPerSecond` (Standard). Verfolgen Sie Ihre Nutzung anhand 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 für den Empfehlungsgeber konfigurieren. Die Mindestanzahl von Empfehlungsanfragen pro Sekunde (`minRecommendationRequestsPerSecond`) gibt den von Amazon Personalize bereitgestellten Basisdurchsatz für Empfehlungsanfragen an. Die Standardeinstellung ist minRecommendationRequestsPerSecond . `1` Eine Empfehlungsanfrage ist ein einziger `GetRecommendations` Vorgang. Der Anforderungsdurchsatz wird in Anfragen pro Sekunde gemessen und Amazon Personalize verwendet Ihre Anfragen pro Sekunde, um Ihre Anfragen pro Stunde und den Preis für Ihre empfohlene Nutzung abzuleiten. Wenn Ihre Anfragen pro Sekunde darüber hinaus steigen`minRecommendationRequestsPerSecond`, 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 ist entweder die Mindestanzahl der Anfragen pro Stunde (basierend auf minRecommendationRequestsPerSecond) oder die tatsächliche 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 beginnen`minRecommendationRequestsPerSecond`, Ihre Nutzung anhand von CloudWatch Amazon-Metriken zu verfolgen und diese dann bei `minRecommendationRequestsPerSecond` Bedarf zu erhöhen. **Status** Ein Empfehlungsgeber kann sich in einem der folgenden Zustände befinden: + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oder- CREATE FAILED + STOP PENDING > STOP IN\$1PROGRESS > INAKTIV > START AUSSTEHEND > START IN\$1PROGRESS > AKTIV + DELETE PENDING > DELETE IN\$1PROGRESS Rufen Sie an, um den Empfehlungsstatus zu erhalten. [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) **Anmerkung** Warten Sie, bis der `status` Status des Empfehlungsgebers erreicht ist, `ACTIVE` bevor Sie den Empfehlungsgeber um Empfehlungen bitten. **Verwandt APIs** + [ListRecommenders](https://docs.aws.amazon.com/personalize/latest/dg/API_ListRecommenders.html) + [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) + [UpdateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateRecommender.html) + [DeleteRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteRecommender.html) ## 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](#API_CreateRecommender_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) der Zieldomänen-Datensatzgruppe für den Empfehlungsgeber. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen. Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+` Erforderlich: Ja ** [name](#API_CreateRecommender_RequestSyntax) ** Der Name des Empfehlungsgebers. 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](#API_CreateRecommender_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) des Rezepts, das der Empfehlungsgeber verwenden wird. Für einen Empfehlungsgeber ist ein Rezept ein Anwendungsfall für Domain-Datensatzgruppen. Nur Anwendungsfälle für Domain-Datensatzgruppen können verwendet werden, um eine Empfehlung zu erstellen. Informationen zu Anwendungsfällen finden Sie unter Anwendungsfälle für [Empfehlungen auswählen](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html). Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen. Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+` Erforderlich: Ja ** [recommenderConfig](#API_CreateRecommender_RequestSyntax) ** Die Konfigurationsdetails des Empfehlungsgebers. Typ: [RecommenderConfig](API_RecommenderConfig.md) Objekt Erforderlich: Nein ** [tags](#API_CreateRecommender_RequestSyntax) ** Eine Liste von [Tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html), die auf den Empfehlungsgeber 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 ``` { "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](#API_CreateRecommender_ResponseSyntax) ** Der Amazon-Ressourcenname (ARN) des Empfehlungsgebers. 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 ein. 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/CreateRecommender) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateRecommender) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateRecommender) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateRecommender) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateRecommender) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateRecommender) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateRecommender) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateRecommender) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateRecommender) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateRecommender)