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 1
L'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
status
Attendi 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
-
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: