View a markdown version of this page

UpdateSolution - 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.

UpdateSolution

Met à jour une solution Amazon Personalize afin d'utiliser une configuration d'entraînement automatique différente. Lorsque vous mettez à jour une solution, vous pouvez modifier si la solution utilise l'entraînement automatique, et vous pouvez modifier la fréquence de l'entraînement. Pour plus d'informations sur la mise à jour d'une solution, consultez la section Mise à jour d'une solution.

Une mise à jour de solution peut se présenter dans l'un des états suivants :

CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -ou- CREATE FAILED

Pour connaître l'état d'une mise à jour de solution, appelez l'opération DescribeSolution API et recherchez l'état dans lelatestSolutionUpdate.

Syntaxe de la requête

{ "performAutoTraining": boolean, "performIncrementalUpdate": boolean, "solutionArn": "string", "solutionUpdateConfig": { "autoTrainingConfig": { "schedulingExpression": "string" }, "eventsConfig": { "eventParametersList": [ { "eventType": "string", "eventValueThreshold": number, "weight": number } ] } } }

Paramètres de demande

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

performAutoTraining

Si la solution utilise la formation automatique pour créer de nouvelles versions de solution (modèles entraînés). Vous pouvez modifier la fréquence d'entraînement en spécifiant un schedulingExpression dans AutoTrainingConfig la configuration de la solution.

Si vous activez la formation automatique, la première formation automatique commence dans l'heure qui suit la fin de la mise à jour de la solution. Si vous créez manuellement une version de solution dans l'heure qui suit, la solution ignore la première formation automatique. Pour plus d'informations sur l'entraînement automatique, consultez la section Configuration de l'entraînement automatique.

Une fois la formation commencée, vous pouvez obtenir le nom de ressource Amazon (ARN) de la version de la solution grâce à l'opération ListSolutionVersions d'API. Pour obtenir son statut, utilisez le DescribeSolutionVersion.

Type : booléen

Obligatoire : non

performIncrementalUpdate

S'il faut effectuer des mises à jour d'entraînement incrémentielles sur votre modèle. Lorsqu'elle est activée, cela permet au modèle d'apprendre plus fréquemment à partir de nouvelles données sans nécessiter de reconversion complète, ce qui permet une personnalisation en temps quasi réel. Ce paramètre n'est pris en charge que pour les solutions qui utilisent la recette de similarité sémantique.

Type : booléen

Obligatoire : non

solutionArn

Le nom de ressource Amazon (ARN) de la solution à mettre à jour.

Type : Chaîne

Contraintes de longueur : longueur maximale de 256.

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

Obligatoire : oui

solutionUpdateConfig

Les nouveaux détails de configuration de la solution.

Type : objet SolutionUpdateConfig

Obligatoire : non

Syntaxe de la réponse

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

solutionArn

La même solution Amazon Resource Name (ARN) que celle indiquée dans la demande.

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

ResourceInUseException

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

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

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 :