View a markdown version of this page

CreateSolutionVersion - Amazon Personalize
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursVoir aussi

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 CreateSolution cette opération et doit être à l'état ACTIF avant d'appelerCreateSolutionVersion. Une nouvelle version de la solution est créée chaque fois que vous appelez cette opération.

Statut

Une version de solution peut se trouver dans l'un des états suivants :

  • CRÉER EN ATTENTE

  • CRÉER EN COURS

  • ACTIF

  • ÉCHEC DE LA CRÉATION

  • CRÉER UN ARRÊT

  • CRÉATION ARRÊTÉE

Pour connaître l'état de la version, appelez DescribeSolutionVersion. Attendez que le statut indique ACTIF avant d'appelerCreateCampaign.

Si l'état indique CREATE FAILED, la réponse inclut une failureReason clé qui décrit pourquoi la tâche a échoué.

API associées

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

Le 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 la 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

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

Si vous utilisez User-Personalization, vous pouvez spécifier un mode d'entraînement deUPDATE. Cela met à jour le modèle afin de prendre en compte de nouveaux éléments pour les recommandations. Il ne s'agit pas d'une reconversion complète. Vous devriez tout de même effectuer une reconversion 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 réglé sur FULL et déployez-la dans une campagne. Pour plus d'informations sur les mises à jour automatiques, voir Mises à jour automatiques.

L'UPDATEoption ne peut être utilisée que si vous disposez déjà d'une version de solution active créée à partir de la solution d'entrée à l'aide de l'FULLoption et que la solution d'entrée a été entraînée avec la User-Personalization recette ou l'ancienne HRNN-Coldstart recette.

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

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

Code d’état HTTP : 400

LimitExceededException

La limite du nombre de requêtes 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

Voir aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS kits SDK spécifiques à une langue, consultez les rubriques suivantes :