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](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) **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. 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 predefinita`minRecommendationRequestsPerSecond`, 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\$1PROGRESS > ACTIVE -oppure- CREATE FAILED + STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START IN SOSPESO > START IN\$1PROGRESS > ACTIVE + DELETE PENDING > DELETE IN\$1PROGRESS Per ottenere lo stato di consigliere, chiama. [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) **Nota** `status`Attendi che arrivi il referente `ACTIVE` prima di chiedergli consigli. **Correlati APIs** + [ListRecommenders](https://docs.aws.amazon.com/personalize/latest/dg/API_ListRecommenders.html) + [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) + [UpdateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateRecommender.html) + [DeleteRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteRecommender.html) ## 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](#API_CreateRecommender_RequestSyntax) ** L'Amazon Resource Name (ARN) del gruppo di set di dati del dominio di destinazione per il programma di raccomandazione. Tipo: String Limitazioni di lunghezza: lunghezza massima di 256. Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` Obbligatorio: sì ** [name](#API_CreateRecommender_RequestSyntax) ** Il nome del segnalatore. Tipo: String 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](#API_CreateRecommender_RequestSyntax) ** 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](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html). Tipo: String Limitazioni di lunghezza: lunghezza massima di 256. Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` Obbligatorio: sì ** [recommenderConfig](#API_CreateRecommender_RequestSyntax) ** I dettagli di configurazione del programma di raccomandazione. Tipo: oggetto [RecommenderConfig](API_RecommenderConfig.md) Obbligatorio: no ** [tags](#API_CreateRecommender_RequestSyntax) ** Un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare al programma di raccomandazione. Tipo: matrice di oggetti [Tag](API_Tag.md) 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](#API_CreateRecommender_ResponseSyntax) ** L'Amazon Resource Name (ARN) del programma di raccomandazione. Tipo: String 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 una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateRecommender) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateRecommender) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateRecommender) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateRecommender) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateRecommender) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateRecommender) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateRecommender) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateRecommender) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateRecommender) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateRecommender)