CreateSolutionVersion - Amazon Personalize

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

CreateSolutionVersion

Entraîne ou réentraîne une solution active dans un groupe de jeux de données personnalisé. Une solution est créée à l'aide de l'CreateSolutionopération et doit être à l'état ACTIF avant d'être appeléeCreateSolutionVersion. Une nouvelle version de la solution est créée chaque fois que vous appelez cette opération.

Statut

Une version de solution peut présenter l'un des états suivants :

  • CRÉER EN ATTENTE

  • CRÉER IN_PROGRESS

  • ACTIF

  • ÉCHEC DE LA CRÉATION

  • CRÉER UN ARRÊT

  • CRÉATION ARRÊTÉE

Pour connaître le statut de la version, appelez DescribeSolutionVersion. Attendez que le statut apparaisse comme ACTIF avant d'appelerCreateCampaign.

Si le statut est CREATE FAILED, la réponse inclut une failureReason clé qui décrit la raison de l'échec de la tâche.

Syntaxe de la requête

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

Paramètres de demande

Cette demande accepte les données suivantes au format JSON.

name

Nom de la version de la solution.

Type : chaîne

Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63.

Modèle : ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

Obligatoire : non

solutionArn

Le nom de ressource Amazon (ARN) de la solution contenant les informations de configuration de formation.

Type : chaîne

Contraintes de longueur : longueur maximale de 256.

Modèle : arn:([a-z\d-]+):personalize:.*:.*:.+

Obligatoire : oui

tags

Liste des balises à appliquer à la version de la solution.

Type : tableau d’objets Tag

Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.

Obligatoire : non

trainingMode

L'étendue de la formation à effectuer lors de la création de la version de la solution. L’argument par défaut est FULL. Cela crée un tout nouveau modèle basé sur l'intégralité des données d'entraînement issues des ensembles de données de votre groupe de jeux de données.

Si vous utilisez la personnalisation utilisateur, vous pouvez spécifier un mode d'entraînement de. UPDATE Cela met à jour le modèle afin de prendre en compte les nouveaux éléments pour les recommandations. Il ne s'agit pas d'une reconversion complète. Vous devez tout de même suivre une rééducation complète chaque semaine. Si vous le spécifiezUPDATE, Amazon Personalize arrêtera les mises à jour automatiques pour la version de la solution. Pour reprendre les mises à jour, créez une nouvelle solution avec le mode formation configuré FULL et déployez-la dans le cadre d'une campagne. Pour plus d'informations sur les mises à jour automatiques, consultez la section Mises à jour automatiques.

L'UPDATEoption ne peut être utilisée que lorsque vous avez déjà créé une version de solution active à partir de la solution d'entrée à l'aide de l'FULLoption et que la solution d'entrée a été formée avec la recette de personnalisation utilisateur ou l'ancienne recette HRNN-ColdStart.

Type : chaîne

Valeurs valides : FULL | UPDATE | AUTOTRAIN

Obligatoire : non

Syntaxe de la réponse

{ "solutionVersionArn": "string" }

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

solutionVersionArn

L'ARN de la nouvelle version de la solution.

Type : chaîne

Contraintes de longueur : longueur maximale de 256.

Modèle : arn:([a-z\d-]+):personalize:.*:.*:.+

Erreurs

InvalidInputException

Entrez une valeur valide pour le champ ou le paramètre.

Code d’état HTTP : 400

LimitExceededException

La limite du nombre de demandes par seconde a été dépassée.

Code d’état HTTP : 400

ResourceAlreadyExistsException

La ressource spécifiée existe déjà.

Code d’état HTTP : 400

ResourceInUseException

La ressource spécifiée est en cours d'utilisation.

Code d’état HTTP : 400

ResourceNotFoundException

Impossible de trouver la ressource spécifiée.

Code d’état HTTP : 400

TooManyTagsException

Vous avez dépassé le nombre maximum de balises que vous pouvez appliquer à cette ressource.

Code d’état HTTP : 400

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :