As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Procurando um ID de correspondência para um fluxo de trabalho de correspondência baseado em regras
<a name="find-match-id"></a>

Depois de concluir um fluxo de trabalho de correspondência baseado em regras, você pode recuperar a ID de correspondência e a regra associada para cada registro processado. Essas informações ajudam você a entender como os registros foram combinados e quais regras foram aplicadas. O procedimento a seguir demonstra como acessar esses dados usando o AWS Entity Resolution console ou a `GetMatchID` API.

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

**Para pesquisar um Match ID usando o console**

1. Faça login no Console de gerenciamento da AWS e abra o AWS Entity Resolution console em [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).

1. **No painel de navegação esquerdo, em **Fluxos de trabalho**, escolha Correspondência.**

1. Escolha o fluxo de trabalho de correspondência baseado em regras que foi processado (o **status do trabalho** é **Concluído**).

1. Na página de detalhes do fluxo de trabalho correspondente, escolha a guia **Corresponder IDs**.

1. Escolha **Pesquisar ID de correspondência**.
**nota**  
A **opção Pesquisar ID de correspondência** só está disponível para fluxos de trabalho correspondentes que usam a cadência de processamento **automático**. Se você tiver selecionado a cadência de processamento **manual**, essa opção aparecerá inativa. Para usar essa opção, edite seu fluxo de trabalho para usar a cadência de processamento **automático**. Para obter mais informações sobre a edição de fluxos de trabalho, consulte[Editando um fluxo de trabalho correspondente](edit-matching-workflow.md).

1. Execute um destes procedimentos:    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/entityresolution/latest/userguide/find-match-id.html)

1. Em **Atributos de registro**, insira o **valor** de uma **chave de correspondência** existente para pesquisar cada registro existente.
**dica**  
Insira o máximo de valores possível para ajudar a encontrar o Match ID. 

1. A opção **Normalizar dados** é selecionada por padrão, para que as entradas de dados sejam normalizadas antes da correspondência. Se você não quiser normalizar dados, desmarque a opção **Normalizar** dados.

1. Se você quiser ver as regras de correspondência, expanda a opção **Exibir regras de correspondência**.

1. Escolha **Look up**.

   Uma mensagem de sucesso aparece informando que o Match ID foi encontrado. 

1. Veja o ID de correspondência correspondente e a regra associada que foi encontrada. 

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

**Para pesquisar um Match ID usando a API**
**nota**  
[Para chamar essa API com sucesso, você deve primeiro executar com êxito um fluxo de trabalho de correspondência baseado em regras usando a StartMatchingJob API.](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_StartMatchingJob.html)   
Para obter uma lista completa das linguagens de programação compatíveis, [consulte a seção Consulte também](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html#API_GetMatchId_SeeAlso) da [API de GetMatch ID](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html).

1. Abra um terminal ou prompt de comando para fazer a solicitação da API.

1. Crie uma solicitação POST para o seguinte endpoint: 

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

1. No cabeçalho da solicitação, Content-type defina application/json o. 

1. No URI da solicitação, especifique seu`workflowName`. 

   O `workflowName` imperativo: 
   + Ter entre 1 e 255 caracteres 
   + Combine o padrão [a-z A-Z \_0-9-] \*

1. Para o corpo da solicitação, forneça o seguinte JSON: 

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

   Em que: 

   `applyNormalization`(opcional) - Defina como `true` para normalizar os atributos definidos no esquema 

   `record`(obrigatório) - O registro para o qual buscar o Match ID

1. Envie a solicitação . 

   Se for bem-sucedido, você receberá uma resposta com o código de status 200 e um corpo JSON contendo: 

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

   O `matchId` é o identificador exclusivo desse grupo de registros correspondentes e `matchRule` indica em qual regra o registro correspondeu. 

   Se a chamada não for bem-sucedida, você poderá receber um destes erros:
   + 403 - AccessDeniedException se você não tiver acesso suficiente
   + 404 - ResourceNotFoundException se o recurso não puder ser encontrado
   + 429 - ThrottlingException se a solicitação foi limitada
   + 400 - ValidationException se a entrada falhar na validação
   + 500 - InternalServerException se houver uma falha de serviço interno

------