Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Ricerca di un Match ID per un flusso di lavoro di abbinamento basato su regole
<a name="find-match-id"></a>

Dopo aver completato un flusso di lavoro di abbinamento basato su regole, puoi recuperare il Match ID e la regola associata per ogni record elaborato. Queste informazioni ti aiutano a capire in che modo i record sono stati abbinati e quali regole sono state applicate. La procedura seguente mostra come accedere a questi dati utilizzando la AWS Entity Resolution console o l'`GetMatchID`API.

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

**Per cercare un Match ID utilizzando la console**

1. Accedi a Console di gestione AWS e apri la AWS Entity Resolution console all'indirizzo [https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/).

1. Nel riquadro di navigazione a sinistra, in **Flussi di lavoro**, scegli **Corrispondenza**.

1. Scegli il flusso di lavoro corrispondente basato su regole che è stato elaborato (**lo stato del Job** è **Completato**).

1. Nella pagina dei dettagli del flusso di lavoro corrispondente, scegli la scheda ** IDsCorrispondenza**.

1. Scegli **Cerca l'ID della corrispondenza**.
**Nota**  
L'opzione **Look up Match ID** è disponibile solo per i flussi di lavoro corrispondenti che utilizzano la cadenza di elaborazione **automatica**. Se hai selezionato l'opzione Cadenza di elaborazione **manuale**, questa opzione apparirà inattiva. Per utilizzare questa opzione, modifica il flusso di lavoro in modo da utilizzare la cadenza di elaborazione **automatica**. Per ulteriori informazioni sulla modifica dei flussi di lavoro, consulta. [Modifica di un flusso di lavoro corrispondente](edit-matching-workflow.md)

1. Esegui una delle seguenti operazioni:    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/entityresolution/latest/userguide/find-match-id.html)

1. Per **gli attributi Record**, inserisci la **chiave **Value** for an existing Match** per cercare ogni record esistente.
**Suggerimento**  
Inserisci il maggior numero possibile di valori per trovare il Match ID. 

1. L'opzione **Normalizza i dati** è selezionata per impostazione predefinita, in modo che gli input di dati vengano normalizzati prima della corrispondenza. **Se non desiderate normalizzare i dati, deselezionate l'opzione Normalizza dati.**

1. Se desideri visualizzare le regole di corrispondenza, espandi **Visualizza** le regole di corrispondenza.

1. Scegliere **Look up (Cerca)**.

   Viene visualizzato un messaggio di successo, che indica che il Match ID è stato trovato. 

1. Visualizza il Match ID corrispondente e la regola associata trovata. 

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

**Per cercare un Match ID utilizzando l'API**
**Nota**  
[Per chiamare correttamente questa API, devi prima aver eseguito correttamente un flusso di lavoro di abbinamento basato su regole utilizzando l'StartMatchingJob API.](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_StartMatchingJob.html)   
Per un elenco completo dei linguaggi di programmazione supportati, consulta la sezione [Vedere anche](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html#API_GetMatchId_SeeAlso) dell'API [GetMatchID](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html).

1. Apri un terminale o un prompt dei comandi per effettuare la richiesta API.

1. Crea una richiesta POST per il seguente endpoint: 

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

1. Nell'intestazione della richiesta, imposta il Content-type su application/json. 

1. Nell'URI della richiesta, specifica il tuo. `workflowName` 

   Il `workflowName` must: 
   + avere una lunghezza compresa tra 1 e 255 caratteri 
   + Corrisponde allo schema [a-zA-Z\_0-9-] \*

1. Per il corpo della richiesta, fornisci il seguente codice JSON: 

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

   Dove: 

   `applyNormalization`(opzionale) - Imposta su `true` per normalizzare gli attributi definiti nello schema 

   `record`(obbligatorio) - Il record per cui recuperare il Match ID

1. Inviare la richiesta . 

   In caso di successo, riceverai una risposta con il codice di stato 200 e un corpo JSON contenente: 

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

   `matchId`è l'identificatore univoco per questo gruppo di record corrispondenti e `matchRule` indica a quale regola corrisponde il record. 

   Se la chiamata non va a buon fine, potresti ricevere uno di questi errori:
   + 403 - AccessDeniedException se non disponi di un accesso sufficiente
   + 404: ResourceNotFoundException se la risorsa non può essere trovata
   + 429 - ThrottlingException se la richiesta è stata limitata
   + 400 - ValidationException se l'input fallisce la convalida
   + 500 - InternalServerException se si verifica un errore interno del servizio

------