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 recommandateur lorsque vous faites une GetRecommendations demande.

Nombre minimal de demandes de recommandation par seconde

Lorsque vous créez un recommandateur, vous pouvez configurer le nombre minimum de demandes de recommandation par seconde du recommandateur. Le nombre minimal de demandes de recommandation par seconde (minRecommendationRequestsPerSecond) indique le débit de base des demandes de recommandation provisionné par Amazon Personalize. La valeur minimale par défaut RecommendationRequestsPerSecond est1. Une demande de recommandation est une GetRecommendations opération unique. Le débit des demandes est mesuré en demandes par seconde et Amazon Personalize utilise vos demandes par seconde pour calculer vos demandes par heure et le prix de l'utilisation de votre recommandation.

Si le nombre de demandes par seconde augmente au-delàminRecommendationRequestsPerSecond, Amazon Personalize redimensionne automatiquement la capacité provisionnée à la hausse et à la baisse, mais jamais en dessous. minRecommendationRequestsPerSecond Il y a un court délai pendant lequel la capacité est augmentée, ce qui peut entraîner une perte de demandes.

Votre facture correspond au plus élevé des deux montants suivants : le nombre minimum de demandes par heure (sur la base du minimumRecommendationRequestsPerSecond) ou le nombre réel de demandes. Le débit de requêtes réel utilisé est calculé comme la moyenne sur requests/second 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 statistiques Amazon, puis de l'minRecommendationRequestsPerSecondaugmenter si nécessaire.

Statut

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

Pour obtenir le statut de recommandateur, 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" ]
         },
         "includedDatasetColumns": { 
            "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

Voir aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS kits SDK spécifiques à une langue, consultez les rubriques suivantes :