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

CreateSolutionVersion

Addestra o riqualifica una soluzione attiva in un gruppo di set di dati personalizzato. Una soluzione viene creata utilizzando l'CreateSolutionoperazione e deve essere nello stato ATTIVO prima della chiamata. CreateSolutionVersion Ogni volta che si richiama 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 NON RIUSCITA

  • CREARE UN'INTERRUZIONE

  • CREAZIONE INTERROTTA

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

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

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\-_]*

Campo obbligatorio: no

solutionArn

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

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

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

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

Campo 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 set di dati.

Se si utilizza User-Personalization, è possibile specificare una modalità di allenamento di. UPDATE Ciò aggiorna il modello per prendere in considerazione nuovi elementi da consigliare. Non si tratta di una riqualificazione completa. Dovresti comunque completare una riqualificazione completa settimanale. 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 distribuiscila in una campagna. Per ulteriori informazioni sugli aggiornamenti automatici, consulta Aggiornamenti automatici.

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

▬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

Hai superato il numero massimo di tag che puoi 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: