Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

GetMatchId

Returns the corresponding Match ID of a customer record if the record has been processed.

Request Syntax


POST /matchingworkflows/workflowName/matches HTTP/1.1
Content-type: application/json

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

URI Request Parameters

The request uses the following URI parameters.

workflowName

The name of the workflow.

Length Constraints: Minimum length of 1. Maximum length of 255.

Pattern: ^[a-zA-Z_0-9-]*$

Required: Yes

Request Body

The request accepts the following data in JSON format.

applyNormalization

Normalizes the attributes defined in the schema in the input data. For example, if an attribute has an AttributeType of PHONE_NUMBER, and the data in the input table is in a format of 1234567890, AWS Entity Resolution will normalize this field in the output to (123)-456-7890.

Type: Boolean

Required: No

record

The record to fetch the Match ID for.

Type: String to string map

Key Length Constraints: Minimum length of 0. Maximum length of 255.

Key Pattern: ^[a-zA-Z_0-9- \t]*$

Value Length Constraints: Minimum length of 0. Maximum length of 255.

Value Pattern: ^[a-zA-Z_0-9-./@ ()+\t]*$

Required: Yes

Response Syntax


HTTP/1.1 200
Content-type: application/json

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

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

matchId

The unique identifiers for this group of match records.

Type: String

matchRule

The rule the record matched on.

Type: String

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You do not have sufficient access to perform this action. HTTP Status Code: 403

HTTP Status Code: 403

InternalServerException

This exception occurs when there is an internal failure in the AWS Entity Resolution service. HTTP Status Code: 500

HTTP Status Code: 500

ResourceNotFoundException

The resource could not be found. HTTP Status Code: 404

HTTP Status Code: 404

ThrottlingException

The request was denied due to request throttling. HTTP Status Code: 429

HTTP Status Code: 429

ValidationException

The input fails to satisfy the constraints specified by AWS Entity Resolution. HTTP Status Code: 400

HTTP Status Code: 400