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 suggerimento con la ricetta (un caso d'uso del gruppo di set di dati di dominio) specificato. Crei consigli per un gruppo di set di dati di dominio e specifichi l'Amazon Resource Name (ARN) del referente quando effettui una richiesta. GetRecommendations
Richieste minime di raccomandazioni al secondo
Importante
Un valore massimo minRecommendationRequestsPerSecond aumenterà la bolletta. Ti consigliamo di iniziare con 1 per minRecommendationRequestsPerSecond (impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando CloudWatch le metriche di Amazon e aumentale minRecommendationRequestsPerSecond se necessario.
Quando crei un consiglio, puoi configurare le richieste minime di consigli del consigliere al secondo. Il numero minimo di richieste di raccomandazione al secondo (minRecommendationRequestsPerSecond) specifica il throughput di riferimento delle richieste di raccomandazione fornito da Amazon Personalize. Il valore minimo predefinito è. RecommendationRequestsPerSecond 1 Una richiesta di raccomandazione è una singola GetRecommendations operazione. Il throughput delle richieste viene misurato in richieste al secondo e Amazon Personalize utilizza le richieste al secondo per ricavare le richieste orarie e il prezzo di utilizzo dei consigli.
Se le tue richieste al secondo aumentano ulteriormenteminRecommendationRequestsPerSecond, Amazon Personalize ridimensiona automaticamente la capacità assegnata verso l'alto e verso il basso, ma mai al di sotto. minRecommendationRequestsPerSecond Si verifica un breve ritardo dovuto all'aumento della capacità che potrebbe causare la perdita delle richieste.
La fattura è il valore maggiore tra le richieste minime orarie (in base al numero minimoRecommendationRequestsPerSecond) o il numero effettivo di richieste. Il throughput effettivo delle richieste utilizzato viene calcolato come media requests/second in una finestra di un'ora. Ti consigliamo di iniziare con l'impostazione predefinitaminRecommendationRequestsPerSecond, monitorare l'utilizzo utilizzando le CloudWatch metriche di Amazon e quindi aumentarle se necessario. minRecommendationRequestsPerSecond
Stato
Un consigliere può trovarsi in uno dei seguenti stati:
-
CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -oppure- CREATE FAILED
-
STOP PENDING > STOP IN_PROGRESS > INACTIVE > START PENDING > START IN_PROGRESS > ACTIVE
-
DELETE PENDING > DELETE IN_PROGRESS
Per ottenere lo status di consigliere, chiama. DescribeRecommender
Nota
statusAttendi lo scadere del numero del consigliere ACTIVE prima di chiedere consigli al consigliere.
Sintassi della richiesta
{
"datasetGroupArn": "string",
"name": "string",
"recipeArn": "string",
"recommenderConfig": {
"enableMetadataWithRecommendations": boolean,
"itemExplorationConfig": {
"string" : "string"
},
"minRecommendationRequestsPerSecond": number,
"trainingDataConfig": {
"excludedDatasetColumns": {
"string" : [ "string" ]
},
"includedDatasetColumns": {
"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 consigliatore.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+Obbligatorio: sì
- name
-
Il nome del consigliere.
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: sì
- recipeArn
-
L'Amazon Resource Name (ARN) della ricetta che verrà utilizzata dal consigliere. Per un consigliere, una ricetta è un caso d'uso di un gruppo di set di dati di dominio. È possibile utilizzare solo i casi d'uso del gruppo di set di dati di dominio per creare un suggerimento. Per informazioni sui casi d'uso, vedi Scelta dei casi d'uso dei consigliatori.
Tipo: stringa
Limitazioni di lunghezza: lunghezza massima di 256.
Modello:
arn:([a-z\d-]+):personalize:.*:.*:.+Obbligatorio: sì
- recommenderConfig
-
I dettagli di configurazione del raccomandatore.
Tipo: oggetto RecommenderConfig
Obbligatorio: no
-
Un elenco di tag da applicare al consigliatore.
Tipo: matrice di oggetti Tag
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.
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 consigliere.
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:
