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.

# Recherche d'un identifiant de match pour un flux de travail de correspondance basé sur des règles
<a name="find-match-id"></a>

Après avoir terminé un flux de travail de correspondance basé sur des règles, vous pouvez récupérer l'ID de correspondance et la règle associée pour chaque enregistrement traité. Ces informations vous aident à comprendre comment les enregistrements ont été mis en correspondance et quelles règles ont été appliquées. La procédure suivante explique comment accéder à ces données à l'aide de la Résolution des entités AWS console ou de l'`GetMatchID`API.

------
#### [ Console ]

**Pour rechercher un Match ID à l'aide de la console**

1. Connectez-vous à la Résolution des entités AWS console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).

1. Dans le volet de navigation de gauche, sous **Workflows**, choisissez **Matching**.

1. Choisissez le flux de travail de correspondance basé sur des règles qui a été traité (le **statut du Job** est **terminé**).

1. Sur la page des détails du flux de travail correspondant, choisissez l' IDsonglet **Match**.

1. Choisissez **Rechercher l'identifiant du match**.
**Note**  
L'option **Rechercher un identifiant de correspondance** n'est disponible que pour les flux de travail correspondants utilisant la cadence de traitement **automatique**. Si vous avez sélectionné la cadence de traitement **manuel**, cette option apparaîtra inactive. Pour utiliser cette option, modifiez votre flux de travail afin d'utiliser la cadence de traitement **automatique**. Pour plus d'informations sur la modification des flux de travail, consultez[Modification d'un flux de travail correspondant](edit-matching-workflow.md).

1. Effectuez l’une des actions suivantes :    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/entityresolution/latest/userguide/find-match-id.html)

1. Pour les **attributs d'enregistrement**, entrez la **valeur** d'une **clé de correspondance** existante pour rechercher chaque enregistrement existant.
**Astuce**  
Entrez autant de valeurs que possible pour aider à trouver le Match ID. 

1. L'option **Normaliser les données** est sélectionnée par défaut afin que les entrées de données soient normalisées avant la mise en correspondance. Si vous ne souhaitez pas normaliser les données, désélectionnez l'option **Normaliser les données**.

1. Si vous souhaitez consulter les règles de correspondance, développez la section **Afficher les règles de correspondance**.

1. Choisissez **Recherche**.

   Un message de réussite apparaît, indiquant que le Match ID a été trouvé. 

1. Affichez le Match ID correspondant et la règle associée qui ont été trouvés. 

------
#### [ API ]

**Pour rechercher un Match ID à l'aide de l'API**
**Note**  
[Pour appeler cette API avec succès, vous devez d'abord avoir exécuté avec succès un flux de travail de correspondance basé sur des règles à l'aide de l'StartMatchingJob API.](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_StartMatchingJob.html)   
Pour obtenir la liste complète des langages de programmation pris en charge, [consultez la section Voir aussi](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html#API_GetMatchId_SeeAlso) de l'[API GetMatch ID](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html).

1. Ouvrez un terminal ou une invite de commande pour effectuer la demande d'API.

1. Créez une requête POST pour le point de terminaison suivant : 

   ```
   /matchingworkflows/workflowName/matches
   ```

1. Dans l'en-tête de la demande, définissez le type de contenu sur application/json. 

1. Dans l'URI de demande, spécifiez votre`workflowName`. 

   Le `workflowName` must : 
   + Comporter entre 1 et 255 caractères 
   + Correspond au modèle [A-za-Z\_0-9-] \*

1. Pour le corps de la requête, fournissez le code JSON suivant : 

   ```
   {
      "applyNormalization": boolean,
      "record": { 
         "string" : "string" 
      }
   }
   ```

   Où : 

   `applyNormalization`(facultatif) - Définissez sur `true` pour normaliser les attributs définis dans le schéma 

   `record`(obligatoire) - L'enregistrement pour lequel récupérer le Match ID

1. Envoyez la demande . 

   En cas de succès, vous recevrez une réponse avec le code d'état 200 et un corps JSON contenant : 

   ```
   {
      "matchId": "string",
      "matchRule": "string"
   }
   ```

   `matchId`Il s'agit de l'identifiant unique de ce groupe d'enregistrements correspondants et `matchRule` indique à quelle règle l'enregistrement correspond. 

   Si l'appel échoue, l'un des messages d'erreur suivants peut s'afficher :
   + 403 - AccessDeniedException si vous ne disposez pas d'un accès suffisant
   + 404 - ResourceNotFoundException si la ressource est introuvable
   + 429 - ThrottlingException si la demande a été limitée
   + 400 - ValidationException si la saisie échoue à la validation
   + 500 - en InternalServerException cas de panne du service interne

------