View a markdown version of this page

CreateSolutionVersion - Amazon Personalize
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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

CreateSolutionVersion

Addestra o riqualifica una soluzione attiva in un gruppo di set di dati personalizzati. Una soluzione viene creata utilizzando l'CreateSolutionoperazione e deve essere nello stato ATTIVO prima della chiamata. CreateSolutionVersion Ogni volta che si chiama questa operazione, viene creata una nuova versione della soluzione.

Stato

Una versione della soluzione può trovarsi in uno dei seguenti stati:

  • CREA IN SOSPESO

  • CREA IN_PROGRESS

  • ACTIVE

  • CREAZIONE FALLITA

  • CREARE UN ARRESTO

  • CREARE FERMATO

Per conoscere lo stato della versione, chiama DescribeSolutionVersion. Attendi che lo stato sia visualizzato come ATTIVO prima di chiamareCreateCampaign.

Se lo stato indica CREATE FAILED, la risposta include una failureReason chiave che descrive il motivo per cui il processo non è riuscito.

API correlate

Sintassi della richiesta

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

Parametri della richiesta

La richiesta accetta i seguenti dati in formato JSON.

name

Il nome della versione della soluzione.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.

Modello: ^[a-zA-Z0-9][a-zA-Z0-9\-_]*

Obbligatorio: no

solutionArn

L'Amazon Resource Name (ARN) della soluzione contenente le informazioni sulla configurazione del training.

Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

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

Obbligatorio: sì

tags

Un elenco di tag da applicare alla versione della soluzione.

Tipo: matrice di oggetti Tag

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.

Obbligatorio: no

trainingMode

L'ambito della formazione da eseguire durante la creazione della versione della soluzione. Il valore predefinito è FULL. Questo crea un modello completamente nuovo basato sulla totalità dei dati di addestramento dei set di dati del gruppo di dati.

Se si utilizza User-Personalization, è possibile specificare una modalità di allenamento di. UPDATE Questo aggiorna il modello per prendere in considerazione nuovi elementi per i consigli. Non è una riqualificazione completa. Dovresti comunque completare una riqualificazione completa settimanalmente. Se lo specifichiUPDATE, Amazon Personalize interromperà gli aggiornamenti automatici per la versione della soluzione. Per riprendere gli aggiornamenti, crea una nuova soluzione con la modalità di formazione impostata FULL e implementala in una campagna. Per ulteriori informazioni sugli aggiornamenti automatici, consulta Aggiornamenti https://docs.aws.amazon.com/personalize/latest/dg/use-case-recipe-features.html#maintaining-with-automatic-updates automatici.

L'UPDATEopzione può essere utilizzata solo se si dispone già di una versione attiva della soluzione creata dalla soluzione di input utilizzando l'FULLopzione e la soluzione di input è stata addestrata con la User-Personalization ricetta o la HRNN-Coldstart ricetta precedente.

Tipo: stringa

Valori validi: FULL | UPDATE | AUTOTRAIN

Campo obbligatorio: no

Sintassi della risposta

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

solutionVersionArn

L'ARN della nuova versione della soluzione.

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

ResourceAlreadyExistsException

La risorsa specificata esiste già.

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

TooManyTagsException

È stato superato il numero massimo di tag che è possibile applicare a questa risorsa.

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: