Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # CreateRecommender Crée une recommandation avec la recette (un cas d'utilisation d'un groupe de jeux de données de domaine) que vous spécifiez. Vous créez des recommandations pour un groupe de jeux de données de domaine et vous spécifiez le nom de ressource Amazon (ARN) du recommandant lorsque vous faites une [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)demande. **Nombre minimal de demandes de recommandation par seconde** **Important** Un montant élevé `minRecommendationRequestsPerSecond` fera augmenter votre facture. Nous vous recommandons de commencer par 1 pour `minRecommendationRequestsPerSecond` (valeur par défaut). Suivez votre consommation à l'aide CloudWatch des statistiques Amazon et augmentez-les `minRecommendationRequestsPerSecond` si nécessaire. Lorsque vous créez un recommandeur, vous pouvez configurer le nombre minimal de demandes de recommandation par seconde. Le nombre minimal de demandes de recommandation par seconde (`minRecommendationRequestsPerSecond`) indique le débit de base de demandes de recommandation fourni par Amazon Personalize. La valeur par défaut minRecommendationRequests PerSecond est`1`. Une demande de recommandation est une `GetRecommendations` opération unique. Le débit de demandes est mesuré en demandes par seconde et Amazon Personalize utilise vos demandes par seconde pour calculer le nombre de demandes par heure et le prix d'utilisation de votre outil de recommandation. Si le nombre de demandes par seconde augmente au-delà`minRecommendationRequestsPerSecond`, Amazon Personalize redimensionne automatiquement la capacité allouée à la hausse ou à la baisse, mais jamais en dessous. `minRecommendationRequestsPerSecond` Il y a un court délai lors de l'augmentation de la capacité, ce qui peut entraîner une perte de demandes. Votre facture correspond au montant le plus élevé entre le nombre minimum de demandes par heure (basé sur minRecommendationRequestsPerSecond) ou le nombre réel de demandes. Le débit de demandes réel utilisé est calculé comme la moyenne sur une requests/second période d'une heure. Nous vous recommandons de commencer par la valeur par défaut`minRecommendationRequestsPerSecond`, de suivre votre utilisation à l'aide CloudWatch des métriques Amazon, puis de l'`minRecommendationRequestsPerSecond`augmenter si nécessaire. **Statut** Un recommandeur peut se trouver dans l'un des états suivants : + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -ou- CREATE FAILED + ARRÊT EN ATTENTE > ARRÊT EN COURS > INACTIF > DÉBUT EN ATTENTE > DÉMARRAGE EN COURS > ACTIF + DELETE PENDING > DELETE IN\$1PROGRESS Pour obtenir le statut de recommandeur, appelez [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html). **Note** Attendez que le `status` recommandateur soit là `ACTIVE` avant de lui demander des recommandations. **Connexe 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) ## Syntaxe de la requête ``` { "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" } ] } ``` ## Paramètres de demande Cette demande accepte les données suivantes au format JSON. ** [datasetGroupArn](#API_CreateRecommender_RequestSyntax) ** Le nom de ressource Amazon (ARN) du groupe de données de domaine de destination pour le recommandeur. Type : Chaîne Contraintes de longueur : longueur maximale de 256. Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+` Obligatoire : oui ** [name](#API_CreateRecommender_RequestSyntax) ** Le nom du recommandant. Type : Chaîne Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63. Modèle : `^[a-zA-Z0-9][a-zA-Z0-9\-_]*` Obligatoire : oui ** [recipeArn](#API_CreateRecommender_RequestSyntax) ** Le nom de ressource Amazon (ARN) de la recette que le recommandeur utilisera. Pour un recommandeur, une recette est un cas d'utilisation d'un groupe de jeux de données de domaine. Seuls les cas d'utilisation de groupes de jeux de données de domaine peuvent être utilisés pour créer un recommandateur. Pour plus d'informations sur les cas d'utilisation, voir [Choisir des cas d'utilisation recommandés](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html). Type : Chaîne Contraintes de longueur : longueur maximale de 256. Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+` Obligatoire : oui ** [recommenderConfig](#API_CreateRecommender_RequestSyntax) ** Les détails de configuration du recommandeur. Type : objet [RecommenderConfig](API_RecommenderConfig.md) Obligatoire : non ** [tags](#API_CreateRecommender_RequestSyntax) ** Liste des [balises](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) à appliquer au recommandeur. Type : tableau d’objets [Tag](API_Tag.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments. Obligatoire : non ## Syntaxe de la réponse ``` { "recommenderArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [recommenderArn](#API_CreateRecommender_ResponseSyntax) ** Le nom de ressource Amazon (ARN) du recommandeur. Type : Chaîne Contraintes de longueur : longueur maximale de 256. Modèle : `arn:([a-z\d-]+):personalize:.*:.*:.+` ## Erreurs ** InvalidInputException ** Entrez une valeur valide pour le champ ou le paramètre. Code d’état HTTP : 400 ** LimitExceededException ** La limite du nombre de demandes par seconde a été dépassée. Code d’état HTTP : 400 ** ResourceAlreadyExistsException ** La ressource spécifiée existe déjà. Code d’état HTTP : 400 ** ResourceInUseException ** La ressource spécifiée est en cours d'utilisation. Code d’état HTTP : 400 ** ResourceNotFoundException ** Impossible de trouver la ressource spécifiée. Code d’état HTTP : 400 ** TooManyTagsException ** Vous avez dépassé le nombre maximum de balises que vous pouvez appliquer à cette ressource. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateRecommender) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateRecommender) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateRecommender) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateRecommender) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateRecommender) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateRecommender) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateRecommender) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateRecommender) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateRecommender) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateRecommender)