本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 查詢規則型比對工作流程的比對 ID
<a name="find-match-id"></a>

完成規則型比對工作流程後，您可以擷取每個已處理記錄的比對 ID 和相關規則。此資訊可協助您了解記錄的比對方式，以及套用了哪些規則。下列程序示範如何使用 AWS Entity Resolution 主控台或 `GetMatchID` API 存取此資料。

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

**使用主控台查詢相符 ID**

1. 登入 AWS 管理主控台 並開啟位於 https：//[https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/) 的 AWS Entity Resolution 主控台。

1. 在左側導覽窗格中的**工作流程**下，選擇**相符**。

1. 選擇已處理的規則型比對工作流程 (**任務狀態**為**已完成**)。

1. 在相符工作流程詳細資訊頁面上，選擇**相符 IDs**索引標籤。

1. 選擇**查詢比對 ID**。
**注意**  
**查詢相符 ID** 選項僅適用於使用**自動**處理節奏的相符工作流程。如果您已選取**手動**處理節奏，此選項將顯示為非作用中。若要使用此選項，請編輯工作流程以使用**自動**處理節奏。如需編輯工作流程的詳細資訊，請參閱 [編輯相符的工作流程](edit-matching-workflow.md)。

1. 執行以下任意一項：    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/entityresolution/latest/userguide/find-match-id.html)

1. 針對**記錄屬性**，輸入現有**相符金鑰****的值**，以查詢每個現有記錄。
**提示**  
輸入盡可能多的值，以協助尋找相符 ID。

1. 預設會選取**標準化資料**選項，以便在比對之前標準化資料輸入。如果您不想標準化資料，請取消選取**標準化資料**選項。

1. 如果您想要檢視相符規則，請展開**檢視相符規則**。

1. 選擇 **Look up** (查閱)。

   隨即出現成功訊息，指出找到相符 ID。

1. 檢視對應的相符 ID 和找到的相關聯規則。

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

**使用 API 查詢相符 ID**
**注意**  
若要成功呼叫此 API，您必須先使用 [StartMatchingJob API](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_StartMatchingJob.html) 成功執行規則型比對工作流程。  
如需支援之程式設計語言的完整清單，請參閱 [GetMatchID API](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html) 的[另請參閱](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html#API_GetMatchId_SeeAlso)一節。

1. 開啟終端機或命令提示以提出 API 請求。

1. 建立對下列端點的 POST 請求：

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

1. 在請求標頭中，將 Content-type 設定為 application/json。

1. 在請求 URI 中，指定您的 `workflowName`。

   必須`workflowName`：
   + 長度介於 1 到 255 個字元之間 
   + 比對模式 【a-zA-Z\_0-9-】\*

1. 針對請求內文，請提供下列 JSON：

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

   其中：

   `applyNormalization` （選用） - 設定為 `true`以標準化結構描述中定義的屬性 

   `record` （必要） - 要擷取 相符 ID 的記錄

1. 傳送 請求。

   如果成功，您會收到狀態碼為 200 的回應，以及包含下列項目的 JSON 內文：

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

   `matchId` 是此相符記錄群組的唯一識別符，並`matchRule`指出記錄相符的規則。

   如果呼叫失敗，您可能會收到下列其中一個錯誤：
   + 403 - 如果您沒有足夠的存取權，則為 AccessDeniedException 
   + 如果找不到資源，則為 404 - ResourceNotFoundException 
   + 429 - 如果請求已調節，則 ThrottlingException 
   + 400 - 如果輸入驗證失敗，則 ValidationException 
   + 500 - 如果發生內部服務故障，則為 InternalServerException 

------