기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 규칙 기반 일치 워크플로에 대한 일치 ID 조회
<a name="find-match-id"></a>

규칙 기반 일치 워크플로를 완료한 후 처리된 각 레코드에 대해 일치 ID 및 관련 규칙을 검색할 수 있습니다. 이 정보는 레코드가 일치하는 방식과 어떤 규칙이 적용되었는지 이해하는 데 도움이 됩니다. 다음 절차에서는 AWS Entity Resolution 콘솔 또는 `GetMatchID` API를 사용하여이 데이터에 액세스하는 방법을 보여줍니다.

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

**콘솔을 사용하여 일치 ID를 조회하려면**

1. 에 로그인 AWS Management Console 하고 [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/ko_kr/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 

------