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 GetRecommendationsdemande.

Nombre minimal de demandes de recommandation par seconde

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 est1. 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 des demandes/seconde sur une période d'une heure. Nous vous recommandons de commencer par la valeur par défautminRecommendationRequestsPerSecond, de suivre votre utilisation à l'aide CloudWatch des métriques Amazon, puis de l'minRecommendationRequestsPerSecondaugmenter si nécessaire.

Statut

Un recommandeur peut se trouver dans l'un des états suivants :

Pour obtenir le statut de recommandeur, appelez DescribeRecommender.

Syntaxe de la requête

{
   "datasetGroupArn": "string",
   "name": "string",
   "recipeArn": "string",
   "recommenderConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "minRecommendationRequestsPerSecond": number,
      "trainingDataConfig": { 
         "excludedDatasetColumns": { 
            "string" : [ "string" ]
         }
      }
   },
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}

Paramètres de demande

Cette demande accepte les données suivantes au format JSON.

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.

Erreurs

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :