As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # CreateRecommender Cria um recomendador com a fórmula (um caso de uso de grupo de conjunto de dados de domínio) que você especificar. Você cria recomendadores para um grupo de conjuntos de dados de domínio e especifica o Amazon Resource Name (ARN) do recomendador ao fazer uma solicitação. [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) **Mínimo de solicitações de recomendação por segundo** **Importante** Uma `minRecommendationRequestsPerSecond` alta aumentará sua conta. Recomendamos começar com 1 para `minRecommendationRequestsPerSecond` (o padrão). Monitore seu uso usando CloudWatch as métricas da Amazon e aumente as `minRecommendationRequestsPerSecond` conforme necessário. Ao criar um recomendador, você pode configurar as solicitações mínimas de recomendação do recomendador por segundo. As solicitações mínimas de recomendação por segundo (`minRecommendationRequestsPerSecond`) especificam o throughput da solicitação de recomendação da linha de base provisionada pelo Amazon Personalize. O padrão minRecommendationRequests PerSecond é`1`. Uma solicitação de recomendação é uma operação `GetRecommendations` única. O throughput de solicitações é medido em solicitações por segundo, e o Amazon Personalize usa suas solicitações por segundo para derivar suas solicitações por hora e o preço do uso do seu recomendador. Se as suas solicitações por segundo aumentarem além de `minRecommendationRequestsPerSecond`, o Amazon Personalize fará o ajuste de escala automático da capacidade provisionada para cima ou para baixo, mas nunca abaixo de `minRecommendationRequestsPerSecond`. Há um pequeno atraso no aumento da capacidade, o que pode causar perda de solicitações. Sua fatura é a maior entre as solicitações mínimas por hora (com base em minRecommendationRequestsPerSecond) ou o número real de solicitações. A taxa de transferência real da solicitação usada é calculada como a média requests/second dentro de uma janela de uma hora. Recomendamos começar com o padrão`minRecommendationRequestsPerSecond`, rastrear seu uso usando CloudWatch as métricas da Amazon e, em seguida, aumentá-las `minRecommendationRequestsPerSecond` conforme necessário. **Status** Um recomendador pode estar em um dos seguintes estados: + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -or- CREATE FAILED + STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START PENDING > START IN\$1PROGRESS > ACTIVE + DELETE PENDING > DELETE IN\$1PROGRESS Para obter o status de recomendador, ligue [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html). **nota** Aguarde até que o `status` do recomendador seja `ACTIVE` antes de pedir recomendações ao recomendador. **Relacionado 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) ## Sintaxe da solicitação ``` { "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" } ] } ``` ## Parâmetros da solicitação A solicitação aceita os dados a seguir no formato JSON. ** [datasetGroupArn](#API_CreateRecommender_RequestSyntax) ** O nome do recurso da Amazon (ARN) do grupo de conjuntos de dados de domínio de destino para o recomendador. Tipo: string Restrições de tamanho: o tamanho máximo é 256. Padrão: `arn:([a-z\d-]+):personalize:.*:.*:.+` Obrigatório: Sim ** [name](#API_CreateRecommender_RequestSyntax) ** O nome do recomendador. Tipo: string Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63. Padrão: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` Obrigatório: Sim ** [recipeArn](#API_CreateRecommender_RequestSyntax) ** O nome do recurso da Amazon (ARN) da fórmula que o recomendador usará. Para um recomendador, uma fórmula é um caso de uso de grupo de conjuntos de dados do domínio. Somente casos de uso de grupo de conjuntos de dados de domínio podem ser usados para criar um recomendador. Para obter informações sobre casos de uso, consulte [Como escolher casos de uso de recomendadores](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html). Tipo: string Restrições de tamanho: o tamanho máximo é 256. Padrão: `arn:([a-z\d-]+):personalize:.*:.*:.+` Obrigatório: Sim ** [recommenderConfig](#API_CreateRecommender_RequestSyntax) ** Os detalhes de configuração do recomendador. Tipo: objeto [RecommenderConfig](API_RecommenderConfig.md) Obrigatório: não ** [tags](#API_CreateRecommender_RequestSyntax) ** Uma lista de [tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) para aplicar ao recomendador. Tipo: matriz de objetos [Tag](API_Tag.md) Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens. Obrigatório: não ## Sintaxe da resposta ``` { "recommenderArn": "string" } ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200. Os dados a seguir são retornados no formato JSON pelo serviço. ** [recommenderArn](#API_CreateRecommender_ResponseSyntax) ** O nome do recurso da Amazon (ARN) do recomendador. Tipo: string Restrições de tamanho: o tamanho máximo é 256. Padrão: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## Erros ** InvalidInputException ** Forneça um valor válido para o campo ou parâmetro. Código de status HTTP: 400 ** LimitExceededException ** O limite de número de solicitações por segundo foi excedido. Código de status HTTP: 400 ** ResourceAlreadyExistsException ** O recurso especificado já existe. Código de status HTTP: 400 ** ResourceInUseException ** O recurso especificado está em uso. Código de status HTTP: 400 ** ResourceNotFoundException ** Não foi possível encontrar o recurso especificado. Código de status HTTP: 400 ** TooManyTagsException ** Você excedeu o número máximo de tags que pode aplicar a esse recurso. Código de Status HTTP: 400 ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateRecommender) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateRecommender) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateRecommender) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateRecommender) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateRecommender) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateRecommender) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateRecommender) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateRecommender) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateRecommender) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateRecommender)