View a markdown version of this page

CreateSolutionVersion - Amazon Personalize
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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.

CreateSolutionVersion

Trainiert oder trainiert eine aktive Lösung in einer benutzerdefinierten Datensatzgruppe erneut. Eine Lösung wird mithilfe der CreateSolution Operation erstellt und muss sich vor dem Aufruf CreateSolutionVersion im Status ACTIVE befinden. Jedes Mal, wenn Sie diesen Vorgang aufrufen, wird eine neue Version der Lösung erstellt.

Status

Eine Lösungsversion kann sich in einem der folgenden Zustände befinden:

  • AUSSTEHEND ERSTELLEN

  • IN_PROGRESS ERSTELLEN

  • ACTIVE

  • DIE ERSTELLUNG IST FEHLGESCHLAGEN

  • ANHALTEN BEIM ERSTELLEN

  • CREATE WURDE GESTOPPT

Rufen Sie an, um den Status der Version abzurufen DescribeSolutionVersion. Warten Sie, bis der Status als AKTIV angezeigt wird, bevor Sie anrufenCreateCampaign.

Wenn als Status CREATE FAILED angezeigt wird, enthält die Antwort einen failureReason Schlüssel, der beschreibt, warum der Job fehlgeschlagen ist.

Verbundene APIs

Anforderungssyntax

{
   "name": "string",
   "solutionArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ],
   "trainingMode": "string"
}

Anforderungsparameter

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

name

Der Name der Lösungsversion.

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: Nein

solutionArn

Der Amazon-Ressourcenname (ARN) der Lösung, die die Informationen zur Trainingskonfiguration enthält.

Typ: Zeichenfolge

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

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

Erforderlich: Ja

tags

Eine Liste von Tags, die auf die Lösungsversion 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

trainingMode

Der Umfang der Schulung, die bei der Erstellung der Lösungsversion durchgeführt werden muss. Der Standardwert ist FULL. Dadurch wird ein völlig neues Modell erstellt, das auf der Gesamtheit der Trainingsdaten aus den Datensätzen in Ihrer Datensatzgruppe basiert.

Wenn Sie verwenden User-Personalization, können Sie einen Trainingsmodus von angeben. UPDATE Dadurch wird das Modell aktualisiert, sodass neue Elemente für Empfehlungen berücksichtigt werden. Es handelt sich nicht um eine vollständige Umschulung. Sie sollten trotzdem wöchentlich eine vollständige Umschulung absolvieren. Wenn Sie dies angebenUPDATE, stoppt Amazon Personalize die automatischen Updates für die Lösungsversion. Um die Updates wieder aufzunehmen, erstellen Sie eine neue Lösung, für die der Trainingsmodus auf eingestellt ist, FULL und stellen Sie sie in einer Kampagne bereit. Weitere Informationen zu automatischen Updates finden Sie unter Automatische Updates.

Die UPDATE Option kann nur verwendet werden, wenn Sie bereits eine aktive Lösungsversion haben, die aus der Eingabelösung erstellt wurde, die die FULL Option verwendet, und die Eingabelösung mit dem User-Personalization Rezept oder dem alten HRNN-Coldstart Rezept trainiert wurde.

Typ: Zeichenfolge

Zulässige Werte: FULL | UPDATE | AUTOTRAIN

Erforderlich: Nein

Antwortsyntax

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

solutionVersionArn

Der ARN der neuen Lösungsversion.

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: