Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # CreateRecommender Crea un recomendador con la receta (un caso de uso de un grupo de conjuntos de datos de dominio) que especifique. Usted crea recomendadores para un grupo de conjuntos de datos de dominio y especifica el nombre de recurso de Amazon (ARN) del recomendante cuando realiza una solicitud. [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) **Solicitudes de recomendación mínimas por segundo** **importante** Un valor elevado de `minRecommendationRequestsPerSecond` aumentará su factura. Le recomendamos empezar con 1 para `minRecommendationRequestsPerSecond` (el valor predeterminado). Realiza un seguimiento de tu consumo mediante CloudWatch las métricas de Amazon y auméntalo `minRecommendationRequestsPerSecond` según sea necesario. Al crear un recomendador, puede configurar las solicitudes de recomendación mínimas por segundo de este. El número mínimo de solicitudes de recomendación por segundo (`minRecommendationRequestsPerSecond`) especifica el rendimiento básico de las solicitudes de recomendación aprovisionado por Amazon Personalize. El valor predeterminado minRecommendationRequests PerSecond es`1`. Una solicitud de recomendación es una operación `GetRecommendations` única. El rendimiento de las solicitudes se mide en solicitudes por segundo y Amazon Personalize utiliza las solicitudes por segundo para derivar las solicitudes por hora y el precio del uso del recomendador. Si sus solicitudes por segundo aumentan más allá de `minRecommendationRequestsPerSecond`, Amazon Personalize escala y reduce automáticamente la capacidad aprovisionada, pero nunca por debajo de `minRecommendationRequestsPerSecond`. Se produce un breve retraso durante el aumento de la capacidad que podría provocar la pérdida de solicitudes. Tu factura es la cantidad mínima de solicitudes por hora (en función de minRecommendationRequestsPerSecond) o la cantidad real de solicitudes, que sea mayor. El rendimiento real de las solicitudes utilizado se calcula como el promedio requests/second en un período de una hora. Te recomendamos empezar por el predeterminado`minRecommendationRequestsPerSecond`, realizar un seguimiento de tu uso mediante CloudWatch las métricas de Amazon y, a continuación, aumentarlo `minRecommendationRequestsPerSecond` según sea necesario. **Estado** Un recomendador puede tener uno de los siguientes estados: + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -o- CREATE FAILED + STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START PENDING > START IN\$1PROGRESS > ACTIVE + DELETE PENDING > DELETE IN\$1PROGRESS Para obtener el estado de recomendante, llama [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html). **nota** Espere a que el valor `status` del recomendador sea `ACTIVE` antes de pedirle recomendaciones. **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) ## Sintaxis de la solicitud ``` { "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 de la solicitud La solicitud acepta los siguientes datos en formato JSON. ** [datasetGroupArn](#API_CreateRecommender_RequestSyntax) ** El nombre de recurso de Amazon (ARN) del grupo de conjuntos de datos del dominio destino para l recomendador. Tipo: cadena Limitaciones de longitud: longitud máxima de 256. Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` Obligatorio: sí ** [name](#API_CreateRecommender_RequestSyntax) ** El nombre del recomendador. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 63. Patrón: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` Obligatorio: sí ** [recipeArn](#API_CreateRecommender_RequestSyntax) ** El nombre de recurso de Amazon (ARN) de la receta que usará el recomendador. Para un recomendador, una receta es un caso de uso de un grupo de conjuntos de datos de dominio. Solo se pueden usar los casos de uso de grupos de conjuntos de datos de dominio para crear un recomendador. Para obtener información sobre los casos de uso, consulte [Elección de los casos de uso de un recomendador](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html). Tipo: cadena Limitaciones de longitud: longitud máxima de 256. Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` Obligatorio: sí ** [recommenderConfig](#API_CreateRecommender_RequestSyntax) ** Los detalles de configuración del recomendador. Tipo: objeto [RecommenderConfig](API_RecommenderConfig.md) Obligatorio: no ** [tags](#API_CreateRecommender_RequestSyntax) ** Lista de [etiquetas](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) que se aplican al recomendador. Tipo: matriz de objetos [Tag](API_Tag.md) Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos. Obligatorio: no ## Sintaxis de la respuesta ``` { "recommenderArn": "string" } ``` ## Elementos de respuesta Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200. El servicio devuelve los datos siguientes en formato JSON. ** [recommenderArn](#API_CreateRecommender_ResponseSyntax) ** El nombre de recurso de Amazon (ARN) del recomendador. Tipo: cadena Limitaciones de longitud: longitud máxima de 256. Patrón: `arn:([a-z\d-]+):personalize:.*:.*:.+` ## Errores ** InvalidInputException ** Proporcione un valor válido para el campo o el parámetro. Código de estado HTTP: 400 ** LimitExceededException ** Se ha excedido el límite en el número de solicitudes por segundo. Código de estado HTTP: 400 ** ResourceAlreadyExistsException ** El recurso especificado ya existe. Código de estado HTTP: 400 ** ResourceInUseException ** El recurso especificado está en uso. Código de estado HTTP: 400 ** ResourceNotFoundException ** No se ha encontrado el recurso especificado. Código de estado HTTP: 400 ** TooManyTagsException ** Ha superado el número máximo de etiquetas que puede aplicar a este recurso. Código de estado HTTP: 400 ## Véase también Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: + [AWS Interfaz de línea de comandos 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)