View a markdown version of this page

UpdateSolution - Amazon Personalize

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

UpdateSolution

Aggiorna una soluzione Amazon Personalize per utilizzare una diversa configurazione di formazione automatica. Quando aggiorni una soluzione, puoi modificare se la soluzione utilizza l'addestramento automatico e puoi modificare la frequenza di formazione. Per ulteriori informazioni sull'aggiornamento di una soluzione, vedere Aggiornamento di una soluzione.

L'aggiornamento di una soluzione può avvenire in uno dei seguenti stati:

CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -oppure- CREATE FAILED

Per ottenere lo stato di un aggiornamento della soluzione, chiama l'operazione DescribeSolution API e trova lo stato nellatestSolutionUpdate.

Sintassi della richiesta

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

Parametri della richiesta

La richiesta accetta i seguenti dati in formato JSON.

performAutoTraining

Se la soluzione utilizza l'addestramento automatico per creare nuove versioni della soluzione (modelli addestrati). È possibile modificare la frequenza di addestramento specificando schedulingExpression a AutoTrainingConfig come parte della configurazione della soluzione.

Se si attiva il training automatico, il primo training automatico inizia entro un'ora dal completamento dell'aggiornamento della soluzione. Se si crea manualmente una versione della soluzione entro un'ora, la soluzione salta il primo training automatico. Per ulteriori informazioni sull'addestramento automatico, vedere Configurazione del training automatico.

Dopo l'inizio del training, puoi ottenere l'Amazon Resource Name (ARN) della versione della soluzione con l'operazione ListSolutionVersions API. Per conoscerne lo stato, usa il DescribeSolutionVersion.

Tipo: Booleano

Obbligatorio: no

performIncrementalUpdate

Se eseguire aggiornamenti incrementali del training sul modello. Se abilitato, ciò consente al modello di apprendere dai nuovi dati con maggiore frequenza senza richiedere una riqualificazione completa, il che consente una personalizzazione quasi in tempo reale. Questo parametro è supportato solo per le soluzioni che utilizzano la ricetta della somiglianza semantica.

Tipo: Booleano

Obbligatorio: no

solutionArn

L'Amazon Resource Name (ARN) della soluzione da aggiornare.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

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

Obbligatorio: sì

solutionUpdateConfig

I nuovi dettagli di configurazione della soluzione.

Tipo: oggetto SolutionUpdateConfig

Obbligatorio: no

Sintassi della risposta

{ "solutionArn": "string" }

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

solutionArn

La stessa soluzione Amazon Resource Name (ARN) indicata nella richiesta.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

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

Errori

InvalidInputException

Fornisci un valore valido per il campo o il parametro.

Codice di stato HTTP: 400

LimitExceededException

Il limite del numero di richieste al secondo è stato superato.

Codice di stato HTTP: 400

ResourceInUseException

La risorsa specificata è in uso.

Codice di stato HTTP: 400

ResourceInUseException

La risorsa specificata è in uso.

Codice di stato HTTP: 400

ResourceNotFoundException

Impossibile trovare la risorsa specificata.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: