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

CreateRecommender

Crea un programma di raccomandazione con la ricetta (un caso d'uso del gruppo di set di dati Domain) specificata. Crei i consiglieri per un gruppo di set di dati di dominio e specifichi l'Amazon Resource Name (ARN) del consulente quando effettui una richiesta. GetRecommendations

Richieste di raccomandazione minime al secondo

Importante

Un massimo minRecommendationRequestsPerSecond aumenterà la tua bolletta. Ti consigliamo di iniziare con 1 per minRecommendationRequestsPerSecond (impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando i CloudWatch parametri di Amazon e minRecommendationRequestsPerSecond aumentali se necessario.

Quando crei un consulente, puoi configurare il numero minimo di richieste di raccomandazione al secondo. Il numero minimo di richieste di raccomandazione al secondo (minRecommendationRequestsPerSecond) specifica il throughput di richieste di raccomandazione di base fornito da Amazon Personalize. minRecommendationRequestsPerSecond 1L'impostazione predefinita è. Una richiesta di raccomandazione è un'unica GetRecommendations operazione. La velocità effettiva delle richieste viene misurata in richieste al secondo e Amazon Personalize utilizza le tue richieste al secondo per ricavare le tue richieste all'ora e il prezzo dell'utilizzo del programma di raccomandazione.

Se le tue richieste al secondo aumentano o diminuiscono minRecommendationRequestsPerSecond ulteriormente, Amazon Personalize aumenta e riduce automaticamente la capacità fornita, ma mai al di sotto. minRecommendationRequestsPerSecond Si verifica un breve ritardo nell'aumento della capacità che potrebbe causare la perdita di richieste.

La fattura corrisponde all'importo maggiore tra il numero minimo di richieste all'ora (in base a minRecommendationRequestsPerSecond) o il numero effettivo di richieste. La velocità effettiva delle richieste utilizzata viene calcolata come la media delle richieste/secondo in una finestra di un'ora. Ti consigliamo di iniziare con l'impostazione predefinitaminRecommendationRequestsPerSecond, monitorare l'utilizzo utilizzando i CloudWatch parametri di Amazon e quindi aumentarli se necessario. minRecommendationRequestsPerSecond

Stato

Un utente che consiglia può trovarsi in uno dei seguenti stati:

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

  • STOP PENDING > STOP IN_PROGRESS > INACTIVE > START IN SOSPESO > START IN_PROGRESS > ACTIVE

  • DELETE PENDING > DELETE IN_PROGRESS

Per ottenere lo stato di consigliere, chiama. DescribeRecommender

Nota

statusAttendi che arrivi il referente ACTIVE prima di chiedere consigli al consulente.

Sintassi della richiesta

{ "datasetGroupArn": "string", "name": "string", "recipeArn": "string", "recommenderConfig": { "enableMetadataWithRecommendations": boolean, "itemExplorationConfig": { "string" : "string" }, "minRecommendationRequestsPerSecond": number, "trainingDataConfig": { "excludedDatasetColumns": { "string" : [ "string" ] } } }, "tags": [ { "tagKey": "string", "tagValue": "string" } ] }

Parametri della richiesta

La richiesta accetta i seguenti dati in formato JSON.

datasetGroupArn

L'Amazon Resource Name (ARN) del gruppo di set di dati del dominio di destinazione per il programma di raccomandazione.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

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

Campo obbligatorio: sì

name

Il nome del segnalatore.

▬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: sì

recipeArn

L'Amazon Resource Name (ARN) della ricetta che utilizzerà il programma di raccomandazione. Per un consulente, una ricetta è un caso d'uso del gruppo di set di dati di dominio. Solo i casi d'uso del gruppo di set di dati Domain possono essere utilizzati per creare un programma di raccomandazione. Per informazioni sui casi d'uso, vedere Scelta dei casi d'uso di Recommender.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza massima di 256.

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

Campo obbligatorio: sì

recommenderConfig

I dettagli di configurazione del programma di raccomandazione.

Tipo: oggetto RecommenderConfig

Campo obbligatorio: no

tags

Un elenco di tag da applicare al programma di raccomandazione.

Tipo: matrice di oggetti Tag

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

Campo obbligatorio: no

Sintassi della risposta

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

recommenderArn

L'Amazon Resource Name (ARN) del programma di raccomandazione.

▬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: