Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Búsqueda de un identificador de coincidencia para un flujo de trabajo de coincidencia basado en reglas
<a name="find-match-id"></a>

Tras completar un flujo de trabajo de coincidencia basado en reglas, puede recuperar el identificador de coincidencia y la regla asociada para cada registro procesado. Esta información le ayuda a comprender cómo se compararon los registros y qué reglas se aplicaron. El siguiente procedimiento muestra cómo acceder a estos datos mediante la AWS Entity Resolution consola o la `GetMatchID` API.

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

**Para buscar un Match ID mediante la consola**

1. Inicia sesión en Consola de administración de AWS y abre la AWS Entity Resolution consola en [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).

1. En el panel de navegación izquierdo, en **Flujos de trabajo**, selecciona **Matching**.

1. Elija el flujo de trabajo coincidente basado en reglas que se ha procesado (el **estado del trabajo** es **Completado**).

1. En la página de detalles del flujo de trabajo coincidente, seleccione la pestaña **ID de coincidencia.**

1. Selecciona **Buscar ID de coincidencia**.
**nota**  
La opción **Buscar ID de coincidencia** solo está disponible para los flujos de trabajo coincidentes que utilizan la cadencia de procesamiento **automática**. Si ha seleccionado la cadencia de procesamiento **manual**, esta opción aparecerá inactiva. Para usar esta opción, edite su flujo de trabajo para usar la cadencia de procesamiento **automática**. Para obtener más información sobre la edición de flujos de trabajo, consulte[Edición de un flujo de trabajo coincidente](edit-matching-workflow.md).

1. Realice una de las siguientes acciones:    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/entityresolution/latest/userguide/find-match-id.html)

1. En el caso de **los atributos del registro**, introduzca el **valor** de una **clave de coincidencia** existente para buscar cada registro existente.
**sugerencia**  
Introduce tantos valores como puedas para ayudarte a encontrar el identificador de coincidencia. 

1. La opción **Normalizar datos** está seleccionada de forma predeterminada, de modo que las entradas de datos se normalizan antes de la coincidencia. Si no desea normalizar los datos, deseleccione la opción **Normalizar datos**.

1. Si desea ver las reglas de coincidencia, expanda la opción **Ver reglas de coincidencia**.

1. Elija **Look up (Buscar)**.

   Aparece un mensaje de confirmación que indica que se ha encontrado el identificador de coincidencia. 

1. Vea el identificador de coincidencia correspondiente y la regla asociada que se encontró. 

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

**Para buscar un identificador de coincidencia mediante la API**
**nota**  
[Para llamar a esta API correctamente, primero debes haber ejecutado correctamente un flujo de trabajo de coincidencia basado en reglas mediante la StartMatchingJob API.](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_StartMatchingJob.html)   
Para obtener una lista completa de los lenguajes de programación compatibles, consulta la sección [Vea también](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html#API_GetMatchId_SeeAlso) de la API de [GetMatchID](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html).

1. Abre un terminal o una línea de comandos para realizar la solicitud de API.

1. Crea una solicitud POST para el siguiente punto final: 

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

1. En el encabezado de la solicitud, Content-type defina el application/json. 

1. En el URI de la solicitud, especifique su`workflowName`. 

   `workflowName`Debe: 
   + Debe tener una longitud de entre 1 y 255 caracteres 
   + Haga coincidir el patrón [a-z A-Z \_0-9-] \*

1. Para el cuerpo de la solicitud, proporciona el siguiente JSON: 

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

   Donde: 

   `applyNormalization`(opcional): configúrelo en `true` para normalizar los atributos definidos en el esquema 

   `record`(obligatorio): el registro del que se va a buscar el identificador de coincidencia

1. Envíe la solicitud . 

   Si se ejecuta correctamente, recibirás una respuesta con el código de estado 200 y un cuerpo JSON que contiene: 

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

   El `matchId` es el identificador único de este grupo de registros coincidentes e `matchRule` indica la regla con la que coincide el registro. 

   Si la llamada no se realiza correctamente, es posible que recibas uno de los siguientes errores:
   + 403: AccessDeniedException si no tienes acceso suficiente
   + 404: ResourceNotFoundException si no se puede encontrar el recurso
   + 429: ThrottlingException si la solicitud se ha limitado
   + 400: ValidationException si la entrada no pasa la validación
   + 500: InternalServerException si hay un fallo en el servicio interno

------