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. Eine Lösung wird mithilfe der CreateSolutionOperation erstellt und muss sich vor dem Aufruf CreateSolutionVersion im Status ACTIVE befinden. Bei jedem Aufruf dieser Operation 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

  • ERSTELLEN IST FEHLGESCHLAGEN

  • STOPPEN ERSTELLEN

  • CREATE HAT AUFGEHÖRT

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

Wenn der Status CREATE FAILED lautet, 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 die Benutzerpersonalisierung verwenden, können Sie einen Trainingsmodus von angeben. UPDATE Dadurch wird das Modell aktualisiert, sodass es neue Elemente für Empfehlungen berücksichtigt. 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 automatische Updates für die Lösungsversion. Um die Updates wieder aufzunehmen, erstellen Sie eine neue Lösung, bei der der Trainingsmodus aktiviert 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 aus der Eingabelösung mit der FULL Option erstellt haben und die Eingabelösung mit dem Benutzerpersonalisierungsrezept oder dem älteren 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 Status Code: 400

LimitExceededException

Das Limit für die Anzahl der Anfragen pro Sekunde wurde überschritten.

HTTP Status Code: 400

ResourceAlreadyExistsException

Die angegebene Ressource ist bereits vorhanden.

HTTP Status Code: 400

ResourceInUseException

Die angegebene Ressource wird verwendet.

HTTP Status Code: 400

ResourceNotFoundException

Die angegebene Ressource konnte nicht gefunden werden.

HTTP Status Code: 400

TooManyTagsException

Sie haben die maximale Anzahl von Tags überschritten, die Sie auf diese Ressource anwenden können.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden: