

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.

# CreateSolution
<a name="API_CreateSolution"></a>

**Wichtig**  
Standardmäßig verwenden alle neuen Lösungen automatisches Training. Bei der automatischen Schulung fallen für Sie Schulungskosten an, solange Ihre Lösung aktiv ist. Um unnötige Kosten zu vermeiden, können Sie die [Lösung aktualisieren, wenn Sie fertig sind, sodass das](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) automatische Training deaktiviert wird. Informationen zu den Schulungskosten finden Sie unter [Amazon Personalize Personalize-Preise](https://aws.amazon.com/personalize/pricing/).

Erstellt die Konfiguration für das Trainieren eines Modells (Erstellen einer Lösungsversion). Diese Konfiguration umfasst das Rezept für das Modelltraining und optionale Trainingskonfigurationen, z. B. Spalten für das Training und Parameter für die Feature-Transformation. Weitere Informationen zur Konfiguration einer Lösung finden Sie unter [Lösung erstellen und konfigurieren](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html). 

 Standardmäßig verwenden neue Lösungen automatische Schulungen, um alle 7 Tage Lösungsversionen zu erstellen. Sie können die Trainingsfrequenz ändern. Die automatische Erstellung der Lösungsversion beginnt innerhalb einer Stunde, nachdem die Lösung AKTIV ist. Wenn Sie innerhalb einer Stunde manuell eine Lösungsversion erstellen, überspringt die Lösung das erste automatische Training. Weitere Informationen finden Sie unter [Automatisches Training konfigurieren](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html).

 Um das automatische Training auszuschalten, setzen Sie `performAutoTraining` den Wert auf False. Wenn Sie das automatische Training deaktivieren, müssen Sie manuell eine Lösungsversion erstellen, indem Sie den [CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html)Vorgang aufrufen.

Nach Beginn der Schulung können Sie den Amazon-Ressourcennamen (ARN) der Lösungsversion mit dem [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API-Vorgang abrufen. Um den Status zu ermitteln, verwenden Sie den [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html). 

Nach Abschluss der Schulung können Sie die Modellgenauigkeit überprüfen, indem Sie anrufen [GetSolutionMetrics](https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html). Wenn Sie mit der Lösungsversion zufrieden sind, stellen Sie sie mithilfe von bereit [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html). Die Kampagne bietet einem Kunden über die [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)API Empfehlungen.

**Anmerkung**  
Amazon Personalize unterstützt derzeit nicht die Konfiguration der Hyperparameter-Optimierung `hpoObjective` für die Lösung.

 **Status** 

Eine Lösung 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 Status der Lösung zu erfahren [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html). Wenn Sie ein manuelles Training verwenden, muss der Status AKTIV sein, bevor Sie anrufen`CreateSolutionVersion`.

**Verwandt APIs**
+  [UpdateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) 
+  [ListSolutions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html) 
+  [CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html) 
+  [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) 
+  [DeleteSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html) 
+  [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) 
+  [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) 

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

```
{
   "datasetGroupArn": "string",
   "eventType": "string",
   "name": "string",
   "performAutoML": boolean,
   "performAutoTraining": boolean,
   "performHPO": boolean,
   "performIncrementalUpdate": boolean,
   "recipeArn": "string",
   "solutionConfig": { 
      "algorithmHyperParameters": { 
         "string" : "string" 
      },
      "autoMLConfig": { 
         "metricName": "string",
         "recipeList": [ "string" ]
      },
      "autoTrainingConfig": { 
         "schedulingExpression": "string"
      },
      "eventsConfig": { 
         "eventParametersList": [ 
            { 
               "eventType": "string",
               "eventValueThreshold": number,
               "weight": number
            }
         ]
      },
      "eventValueThreshold": "string",
      "featureTransformationParameters": { 
         "string" : "string" 
      },
      "hpoConfig": { 
         "algorithmHyperParameterRanges": { 
            "categoricalHyperParameterRanges": [ 
               { 
                  "name": "string",
                  "values": [ "string" ]
               }
            ],
            "continuousHyperParameterRanges": [ 
               { 
                  "maxValue": number,
                  "minValue": number,
                  "name": "string"
               }
            ],
            "integerHyperParameterRanges": [ 
               { 
                  "maxValue": number,
                  "minValue": number,
                  "name": "string"
               }
            ]
         },
         "hpoObjective": { 
            "metricName": "string",
            "metricRegex": "string",
            "type": "string"
         },
         "hpoResourceConfig": { 
            "maxNumberOfTrainingJobs": "string",
            "maxParallelTrainingJobs": "string"
         }
      },
      "optimizationObjective": { 
         "itemAttribute": "string",
         "objectiveSensitivity": "string"
      },
      "trainingDataConfig": { 
         "excludedDatasetColumns": { 
            "string" : [ "string" ]
         },
         "includedDatasetColumns": { 
            "string" : [ "string" ]
         }
      }
   },
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

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

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [datasetGroupArn](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-datasetGroupArn"></a>
Der Amazon-Ressourcenname (ARN) der Datensatz-Gruppe, die die Trainingsdaten bereitstellt.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Ja

 ** [eventType](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-eventType"></a>
Wenn Sie mehrere Ereignistypen haben (unter Verwendung eines `EVENT_TYPE` Schemafelds), gibt dieser Parameter an, welcher Ereignistyp (z. B. „Klicken“ oder „Gefällt mir“) für das Training des Modells verwendet wird.  
Wenn Sie keine angeben`eventType`, verwendet Amazon Personalize alle Interaktionen für das Training mit gleichem Gewicht, unabhängig vom Typ.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Erforderlich: Nein

 ** [name](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-name"></a>
Der Name für die Lösung.  
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

 ** [performAutoML](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-performAutoML"></a>
Wir raten von der Verwendung von automatisiertem Machine Learning ab. Ordnen Sie Ihren Anwendungsfall stattdessen den verfügbaren Amazon-Personalize-Rezepten zu. Weitere Informationen finden Sie unter [Ein Rezept auswählen](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html).
Ob automatisiertes maschinelles Lernen (AutoML) durchgeführt werden soll. Der Standardwert ist `false`. In diesem Fall müssen Sie Folgendes angeben`recipeArn`.  
Wenn diese Option aktiviert ist`true`, analysiert Amazon Personalize Ihre Trainingsdaten und wählt das optimale USER\$1PERSONALIZATION-Rezept und die optimalen Hyperparameter aus. In diesem Fall müssen Sie es weglassen. `recipeArn` Amazon Personalize ermittelt das optimale Rezept, indem Tests mit unterschiedlichen Werten für die Hyperparameter ausgeführt werden. AutoML verlängert den Trainingsprozess im Vergleich zur Auswahl eines bestimmten Rezepts.  
Typ: Boolesch  
Erforderlich: Nein

 ** [performAutoTraining](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-performAutoTraining"></a>
Ob die Lösung automatisches Training verwendet, um neue Lösungsversionen (trainierte Modelle) zu erstellen. Die Standardeinstellung ist `True` und die Lösung erstellt automatisch alle 7 Tage neue Lösungsversionen. Sie können die Trainingshäufigkeit ändern, indem Sie `schedulingExpression` im `AutoTrainingConfig` Rahmen der Lösungskonfiguration eine angeben. Weitere Informationen zum automatischen Training finden Sie unter [Automatisches Training konfigurieren](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html).  
 Die automatische Erstellung der Lösungsversionen beginnt innerhalb einer Stunde, nachdem die Lösung AKTIV ist. Wenn Sie innerhalb einer Stunde manuell eine Lösungsversion erstellen, überspringt die Lösung das erste automatische Training.   
 Nach Beginn der Schulung können Sie den Amazon-Ressourcennamen (ARN) der Lösungsversion mit dem [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API-Vorgang abrufen. Um den Status zu ermitteln, verwenden Sie den [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html).   
Typ: Boolesch  
Erforderlich: Nein

 ** [performHPO](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-performHPO"></a>
Ob eine Hyperparameter-Optimierung (HPO) für das angegebene oder ausgewählte Rezept durchgeführt werden soll. Der Standardwert ist `false`.  
Wenn Sie AutoML ausführen, ist dieser Parameter immer gültig `true` und Sie sollten ihn nicht auf `false` setzen.  
Typ: Boolesch  
Erforderlich: Nein

 ** [performIncrementalUpdate](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-performIncrementalUpdate"></a>
Gibt an, ob inkrementelle Trainingsupdates an Ihrem Modell durchgeführt werden sollen. Wenn diese Option aktiviert ist, kann das Modell häufiger aus neuen Daten lernen, ohne dass eine vollständige Schulung erforderlich ist, was eine Personalisierung nahezu in Echtzeit ermöglicht. Dieser Parameter wird nur für Lösungen unterstützt, die das Rezept für semantische Ähnlichkeit verwenden.  
Typ: Boolesch  
Erforderlich: Nein

 ** [recipeArn](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-recipeArn"></a>
Der Amazon-Ressourcenname (ARN) des Rezepts, das für das Modelltraining verwendet werden soll. Dies ist erforderlich, wenn der Wert falsch `performAutoML` ist. Informationen zu den verschiedenen Amazon Personalize Personalize-Rezepten und ihren ARNs finden Sie unter [Ein Rezept auswählen](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html).   
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Erforderlich: Nein

 ** [solutionConfig](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-solutionConfig"></a>
Die Konfigurationseigenschaften für die Lösung. Wenn auf true gesetzt `performAutoML` ist, wertet Amazon Personalize nur den `autoMLConfig` Abschnitt der Lösungskonfiguration aus.  
Amazon Personalize unterstützt derzeit nicht die Konfiguration von `hpoObjective`.
Typ: [SolutionConfig](API_SolutionConfig.md) Objekt  
Erforderlich: Nein

 ** [tags](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-tags"></a>
Eine Liste von [Tags, die auf](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) die Lösung 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
<a name="API_CreateSolution_ResponseSyntax"></a>

```
{
   "solutionArn": "string"
}
```

## Antwortelemente
<a name="API_CreateSolution_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.

 ** [solutionArn](#API_CreateSolution_ResponseSyntax) **   <a name="personalize-CreateSolution-response-solutionArn"></a>
Der ARN der Lösung.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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

 ** 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:
<a name="API_CreateSolution_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/CreateSolution) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSolution) 