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

# 为基于规则的匹配工作流程查找匹配 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. 选择已处理的基于规则的匹配工作流程（**作业状态**为 “已**完成”**）。

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，必须先使用 [ StartMatchingJob API ](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_StartMatchingJob.html) 成功运行基于规则的匹配工作流程。  
有关支持的编程语言的完整列表，请参阅 [ GetMatch ID API 的 “[另请参阅](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html#API_GetMatchId_SeeAlso)” 部分](https://docs.aws.amazon.com/entityresolution/latest/apireference/API_GetMatchId.html)。

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 如果出现内部服务故障

------