View a markdown version of this page

CreateMetricAttribution - Amazon Personalize

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.

CreateMetricAttribution

Crée une attribution métrique. Une attribution métrique crée des rapports sur les données que vous importez dans Amazon Personalize. Selon la manière dont vous avez importé les données, vous pouvez consulter les rapports sur Amazon CloudWatch ou Amazon S3. Pour plus d'informations, voir Mesurer l'impact des recommandations.

Syntaxe de la requête

{ "datasetGroupArn": "string", "metrics": [ { "eventType": "string", "expression": "string", "metricName": "string" } ], "metricsOutputConfig": { "roleArn": "string", "s3DataDestination": { "kmsKeyArn": "string", "path": "string" } }, "name": "string" }

Paramètres de demande

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

datasetGroupArn

Le nom de ressource Amazon (ARN) du groupe de jeux de données de destination pour l'attribution des métriques.

Type : Chaîne

Contraintes de longueur : longueur maximale de 256.

Modèle : arn:([a-z\d-]+):personalize:.*:.*:.+

Obligatoire : oui

metrics

Une liste d'attributs de métrique pour l'attribution de métrique. Chaque attribut de métrique spécifie un type d'événement à suivre et une fonction. Les fonctions disponibles sont SUM() ouSAMPLECOUNT(). Pour les fonctions SUM (), indiquez le type de jeu de données (Interactions ou Items) et la colonne à additionner en tant que paramètre. Par exemple SUM (Items.PRICE).

Type : tableau d’objets MetricAttribute

Membres du tableau : nombre maximum de 10 éléments.

Obligatoire : oui

metricsOutputConfig

Les détails de configuration de sortie pour l'attribution des métriques.

Type : objet MetricAttributionOutput

Obligatoire : oui

name

Nom pour l'attribution de la métrique.

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

Syntaxe de la réponse

{ "metricAttributionArn": "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.

metricAttributionArn

L'Amazon Resource Name (ARN) pour la nouvelle attribution de métrique.

Type : Chaîne

Contraintes de longueur : longueur maximale de 256.

Modèle : arn:([a-z\d-]+):personalize:.*:.*:.+

Erreurs

InvalidInputException

Fournissez une valeur valide pour le champ ou le paramètre.

Code d’état HTTP : 400

LimitExceededException

La limite du nombre de requêtes 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

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 :