本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 为基于规则的匹配工作流程查找匹配 ID
<a name="find-match-id"></a>

完成基于规则的匹配工作流程后，您可以检索每条已处理记录的匹配 ID 和关联规则。此信息可帮助您了解记录是如何匹配的，以及应用了哪些规则。以下过程演示如何使用 AWS Entity Resolution 数据匹配服务 控制台或 `GetMatchID` API 访问这些数据。

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

**使用控制台查找比赛 ID**

1. 登录 AWS 管理控制台 并打开 AWS Entity Resolution 数据匹配服务 控制台，网址为[https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/)。

1. 在左侧导航窗格的 “**工作流程**” 下，选择 “**匹配**”。

1. 选择已处理的基于规则的匹配工作流（Job **状态为 “**已**完成**”）。

1. 在匹配工作流程详细信息页面上，选择**匹配 ID** 选项卡。

1. 选择 “**查找匹配 ID**”。
**注意**  
“**查找匹配 ID**” 选项仅适用于使用**自动**处理节奏的匹配工作流程。如果您选择了**手动**处理节奏，则此选项将显示为非活动状态。要使用此选项，请编辑您的工作流程以使用**自动**处理节奏。有关编辑工作流程的更多信息，请参阅[编辑匹配的工作流程](edit-matching-workflow.md)。

1. 请执行以下操作之一：    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_cn/entityresolution/latest/userguide/find-match-id.html)

1. 在 **“记录属性”** 中，输入现有**匹配键**的**值**，以查找每条现有记录。
**提示**  
输入尽可能多的值以帮助找到匹配 ID。

1. 默认情况下，“**标准化数据**” 选项处于选中状态，以便在匹配之前对数据输入进行标准化。如果您不想对数据进行标准化处理，请取消选择 “**标准化**数据” 选项。

1. 如果要查看匹配规则，请展开**查看匹配规则**。

1. 选择**查找**。

   将显示一条成功消息，说明已找到匹配ID。

1. 查看相应的匹配 ID 和找到的关联规则。

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

**使用 API 查找匹配 ID**
**注意**  
[要成功调用此 API，您必须先使用该 API 成功运行基于规则的匹配工作流程。StartMatchingJob ](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-z A-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 如果内部服务出现故障

------