翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ルールベースの一致ワークフローの一致 ID を検索する
<a name="find-match-id"></a>

ルールベースのマッチングワークフローが完了したら、処理された各レコードの一致 ID と関連するルールを取得できます。この情報は、レコードがどのように照合され、どのルールが適用されたかを理解するのに役立ちます。次の手順は、 AWS Entity Resolution コンソールまたは `GetMatchID` API を使用してこのデータにアクセスする方法を示しています。

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

**コンソールを使用して一致 ID を検索するには**

1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/entityresolution/](https://console.aws.amazon.com/entityresolution/) で AWS Entity Resolution コンソールを開きます。

1. 左側のナビゲーションペイン**のワークフロー**で、**一致**を選択します。

1. 処理されたルールベースのマッチングワークフローを選択します (**ジョブのステータス**は**完了**です）。

1. 一致するワークフローの詳細ページで、**一致 IDs**タブを選択します。

1. **一致 ID の検索** を選択します。
**注記**  
**Look up match ID** オプションは、**自動**処理頻度を使用するマッチングワークフローでのみ使用できます。**手動**処理頻度を選択した場合、このオプションは非アクティブになります。このオプションを使用するには、ワークフローを編集して**自動**処理の頻度を使用します。ワークフローの編集の詳細については、「」を参照してください[一致するワークフローの編集](edit-matching-workflow.md)。

1. 次のいずれかを行います。    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/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) を使用してルールベースのマッチングワークフローを正常に実行する必要があります。  
サポートされているプログラミング言語の完全なリストについては、[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](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 

------