openapi: 3.0.0 info: version: '2018-05-10' x-release: v4 title: AWS EntityResolution Matchingworkflows API description:
Welcome to the AWS Entity Resolution API Reference.
AWS Entity Resolution is an AWS service that provides pre-configured entity resolution capabilities that enable developers and analysts at advertising and marketing companies to build an accurate and complete view of their consumers.
With AWS Entity Resolution, you have the ability to match source records containing consumer identifiers, such as name, email address, and phone number. This holds true even when these records have incomplete or conflicting identifiers. For example, AWS Entity Resolution can effectively match a source record from a customer relationship management (CRM) system, which includes account information like first name, last name, postal address, phone number, and email address, with a source record from a marketing system containing campaign information, such as username and email address.
To learn more about AWS Entity Resolution concepts, procedures, and best practices, see the AWS Entity Resolution User Guide.
x-logo: url: https://twitter.com/awscloud/profile_image?size=original backgroundColor: '#FFFFFF' termsOfService: https://aws.amazon.com/service-terms/ contact: name: Mike Ralphson email: mike.ralphson@gmail.com url: https://github.com/mermade/aws2openapi x-twitter: PermittedSoc license: name: Apache 2.0 License url: http://www.apache.org/licenses/ x-providerName: amazonaws.com x-serviceName: entityresolution x-aws-signingName: entityresolution x-origin: - contentType: application/json url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/entityresolution-2018-05-10.normal.json converter: url: https://github.com/mermade/aws2openapi version: 1.0.0 x-apisguru-driver: external x-apiClientRegistration: url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct x-apisguru-categories: - cloud x-preferred: true servers: - url: http://entityresolution.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The AWSEntityResolution multi-region endpoint - url: https://entityresolution.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The AWSEntityResolution multi-region endpoint - url: http://entityresolution.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The AWSEntityResolution endpoint for China (Beijing) and China (Ningxia) - url: https://entityresolution.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The AWSEntityResolution endpoint for China (Beijing) and China (Ningxia) security: - hmac: [] tags: - name: Matchingworkflows paths: /matchingworkflows: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: CreateMatchingWorkflow description: Creates aMatchingWorkflow object which stores the configuration of the data processing job to be run. It is important to note that there should not be a pre-existing MatchingWorkflow with the same name. To modify an existing workflow, utilize the UpdateMatchingWorkflow API.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/CreateMatchingWorkflowOutput'
examples:
CreateMatchingWorkflow200Example:
summary: Default CreateMatchingWorkflow 200 response
x-microcks-default: true
value:
description: Example description
incrementalRunConfig: example
inputSourceConfig: example
outputSourceConfig: example
resolutionTechniques: example
'480':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
examples:
CreateMatchingWorkflow480Example:
summary: Default CreateMatchingWorkflow 480 response
x-microcks-default: true
value: {}
'481':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
examples:
CreateMatchingWorkflow481Example:
summary: Default CreateMatchingWorkflow 481 response
x-microcks-default: true
value: {}
'482':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
examples:
CreateMatchingWorkflow482Example:
summary: Default CreateMatchingWorkflow 482 response
x-microcks-default: true
value: {}
'483':
description: ExceedsLimitException
content:
application/json:
schema:
$ref: '#/components/schemas/ExceedsLimitException'
examples:
CreateMatchingWorkflow483Example:
summary: Default CreateMatchingWorkflow 483 response
x-microcks-default: true
value: {}
'484':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
examples:
CreateMatchingWorkflow484Example:
summary: Default CreateMatchingWorkflow 484 response
x-microcks-default: true
value: {}
'485':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
examples:
CreateMatchingWorkflow485Example:
summary: Default CreateMatchingWorkflow 485 response
x-microcks-default: true
value: {}
parameters: []
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- inputSourceConfig
- outputSourceConfig
- resolutionTechniques
- roleArn
- workflowName
properties:
description:
description: A description of the workflow.
type: string
minLength: 0
maxLength: 255
incrementalRunConfig:
description: An object which defines an incremental run type and has only incrementalRunType as a field.
type: object
properties:
incrementalRunType:
allOf:
- $ref: '#/components/schemas/IncrementalRunType'
- description: 'The type of incremental run. It takes only one value: IMMEDIATE.'
inputSourceConfig:
description: A list of InputSource objects, which have the fields InputSourceARN and SchemaName.
type: array
items:
$ref: '#/components/schemas/InputSource'
minItems: 1
maxItems: 20
outputSourceConfig:
description: A list of OutputSource objects, each of which contains fields OutputS3Path, ApplyNormalization, and Output.
type: array
items:
$ref: '#/components/schemas/OutputSource'
minItems: 1
maxItems: 1
resolutionTechniques:
description: 'An object which defines the resolutionType and the ruleBasedProperties '
type: object
properties:
resolutionType:
allOf:
- $ref: '#/components/schemas/ResolutionType'
- description: 'There are two types of matching, RULE_MATCHING and ML_MATCHING '
ruleBasedProperties:
allOf:
- $ref: '#/components/schemas/RuleBasedProperties'
- description: An object which defines the list of matching rules to run and has a field Rules, which is a list of rule objects.
roleArn:
description: The Amazon Resource Name (ARN) of the IAM role. AWS Entity Resolution assumes this role to create resources on your behalf as part of workflow execution.
type: string
tags:
description: The tags used to organize, track, or control access for this resource.
type: object
minProperties: 0
maxProperties: 200
additionalProperties:
$ref: '#/components/schemas/TagValue'
workflowName:
description: The name of the workflow. There cannot be multiple DataIntegrationWorkflows with the same name.
type: string
pattern: ^[a-zA-Z_0-9-]*$
minLength: 0
maxLength: 255
examples:
CreateMatchingWorkflowRequestExample:
summary: Default CreateMatchingWorkflow request
x-microcks-default: true
value:
description: Example description
incrementalRunConfig: {}
inputSourceConfig: []
outputSourceConfig: []
resolutionTechniques: {}
summary: Amazon Entity Resolution CreateMatchingWorkflow
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Matchingworkflows
get:
operationId: ListMatchingWorkflows
description: Returns a list of all the MatchingWorkflows that have been created for an AWS account.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ListMatchingWorkflowsOutput'
examples:
ListMatchingWorkflows200Example:
summary: Default ListMatchingWorkflows 200 response
x-microcks-default: true
value:
nextToken: example
workflowSummaries: example
'480':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
examples:
ListMatchingWorkflows480Example:
summary: Default ListMatchingWorkflows 480 response
x-microcks-default: true
value: {}
'481':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
examples:
ListMatchingWorkflows481Example:
summary: Default ListMatchingWorkflows 481 response
x-microcks-default: true
value: {}
'482':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
examples:
ListMatchingWorkflows482Example:
summary: Default ListMatchingWorkflows 482 response
x-microcks-default: true
value: {}
'483':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
examples:
ListMatchingWorkflows483Example:
summary: Default ListMatchingWorkflows 483 response
x-microcks-default: true
value: {}
parameters:
- name: maxResults
in: query
required: false
description: The maximum number of objects returned per page.
schema:
type: integer
maximum: 25
- name: nextToken
in: query
required: false
description: The pagination token from the previous ListSchemaMappings API call.
schema:
type: string
pattern: ^[a-zA-Z_0-9-=+/]*$
minLength: 1
maxLength: 1024
summary: Amazon Entity Resolution ListMatchingWorkflows
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Matchingworkflows
/matchingworkflows/{workflowName}:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
delete:
operationId: DeleteMatchingWorkflow
description: Deletes the MatchingWorkflow with a given name. This operation will succeed even if a workflow with the given name does not exist.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/DeleteMatchingWorkflowOutput'
examples:
DeleteMatchingWorkflow200Example:
summary: Default DeleteMatchingWorkflow 200 response
x-microcks-default: true
value:
message: example
'480':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
examples:
DeleteMatchingWorkflow480Example:
summary: Default DeleteMatchingWorkflow 480 response
x-microcks-default: true
value: {}
'481':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
examples:
DeleteMatchingWorkflow481Example:
summary: Default DeleteMatchingWorkflow 481 response
x-microcks-default: true
value: {}
'482':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
examples:
DeleteMatchingWorkflow482Example:
summary: Default DeleteMatchingWorkflow 482 response
x-microcks-default: true
value: {}
'483':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
examples:
DeleteMatchingWorkflow483Example:
summary: Default DeleteMatchingWorkflow 483 response
x-microcks-default: true
value: {}
parameters:
- name: workflowName
in: path
required: true
description: The name of the workflow to be retrieved.
schema:
type: string
pattern: ^[a-zA-Z_0-9-]*$
minLength: 0
maxLength: 255
summary: Amazon Entity Resolution DeleteMatchingWorkflow
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Matchingworkflows
get:
operationId: GetMatchingWorkflow
description: Returns the MatchingWorkflow with a given name, if it exists.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/GetMatchingWorkflowOutput'
examples:
GetMatchingWorkflow200Example:
summary: Default GetMatchingWorkflow 200 response
x-microcks-default: true
value:
createdAt: example
description: Example description
incrementalRunConfig: example
inputSourceConfig: example
outputSourceConfig: example
'480':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
examples:
GetMatchingWorkflow480Example:
summary: Default GetMatchingWorkflow 480 response
x-microcks-default: true
value: {}
'481':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
examples:
GetMatchingWorkflow481Example:
summary: Default GetMatchingWorkflow 481 response
x-microcks-default: true
value: {}
'482':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
examples:
GetMatchingWorkflow482Example:
summary: Default GetMatchingWorkflow 482 response
x-microcks-default: true
value: {}
'483':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
examples:
GetMatchingWorkflow483Example:
summary: Default GetMatchingWorkflow 483 response
x-microcks-default: true
value: {}
'484':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
examples:
GetMatchingWorkflow484Example:
summary: Default GetMatchingWorkflow 484 response
x-microcks-default: true
value: {}
parameters:
- name: workflowName
in: path
required: true
description: The name of the workflow.
schema:
type: string
pattern: ^[a-zA-Z_0-9-]*$
minLength: 0
maxLength: 255
summary: Amazon Entity Resolution GetMatchingWorkflow
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Matchingworkflows
put:
operationId: UpdateMatchingWorkflow
description: Updates an existing MatchingWorkflow. This method is identical to CreateMatchingWorkflow, except it uses an HTTP PUT request instead of a POST request, and the MatchingWorkflow must already exist for the method to succeed.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/UpdateMatchingWorkflowOutput'
examples:
UpdateMatchingWorkflow200Example:
summary: Default UpdateMatchingWorkflow 200 response
x-microcks-default: true
value:
description: Example description
incrementalRunConfig: example
inputSourceConfig: example
outputSourceConfig: example
resolutionTechniques: example
'480':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
examples:
UpdateMatchingWorkflow480Example:
summary: Default UpdateMatchingWorkflow 480 response
x-microcks-default: true
value: {}
'481':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
examples:
UpdateMatchingWorkflow481Example:
summary: Default UpdateMatchingWorkflow 481 response
x-microcks-default: true
value: {}
'482':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
examples:
UpdateMatchingWorkflow482Example:
summary: Default UpdateMatchingWorkflow 482 response
x-microcks-default: true
value: {}
'483':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
examples:
UpdateMatchingWorkflow483Example:
summary: Default UpdateMatchingWorkflow 483 response
x-microcks-default: true
value: {}
'484':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
examples:
UpdateMatchingWorkflow484Example:
summary: Default UpdateMatchingWorkflow 484 response
x-microcks-default: true
value: {}
parameters:
- name: workflowName
in: path
required: true
description: The name of the workflow to be retrieved.
schema:
type: string
pattern: ^[a-zA-Z_0-9-]*$
minLength: 0
maxLength: 255
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- inputSourceConfig
- outputSourceConfig
- resolutionTechniques
- roleArn
properties:
description:
description: A description of the workflow.
type: string
minLength: 0
maxLength: 255
incrementalRunConfig:
description: An object which defines an incremental run type and has only incrementalRunType as a field.
type: object
properties:
incrementalRunType:
allOf:
- $ref: '#/components/schemas/IncrementalRunType'
- description: 'The type of incremental run. It takes only one value: IMMEDIATE.'
inputSourceConfig:
description: A list of InputSource objects, which have the fields InputSourceARN and SchemaName.
type: array
items:
$ref: '#/components/schemas/InputSource'
minItems: 1
maxItems: 20
outputSourceConfig:
description: A list of OutputSource objects, each of which contains fields OutputS3Path, ApplyNormalization, and Output.
type: array
items:
$ref: '#/components/schemas/OutputSource'
minItems: 1
maxItems: 1
resolutionTechniques:
description: 'An object which defines the resolutionType and the ruleBasedProperties '
type: object
properties:
resolutionType:
allOf:
- $ref: '#/components/schemas/ResolutionType'
- description: 'There are two types of matching, RULE_MATCHING and ML_MATCHING '
ruleBasedProperties:
allOf:
- $ref: '#/components/schemas/RuleBasedProperties'
- description: An object which defines the list of matching rules to run and has a field Rules, which is a list of rule objects.
roleArn:
description: The Amazon Resource Name (ARN) of the IAM role. AWS Entity Resolution assumes this role to create resources on your behalf as part of workflow execution.
type: string
examples:
UpdateMatchingWorkflowRequestExample:
summary: Default UpdateMatchingWorkflow request
x-microcks-default: true
value:
description: Example description
incrementalRunConfig: {}
inputSourceConfig: []
outputSourceConfig: []
resolutionTechniques: {}
summary: Amazon Entity Resolution UpdateMatchingWorkflow
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Matchingworkflows
/matchingworkflows/{workflowName}/matches:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
post:
operationId: GetMatchId
description: Returns the corresponding Match ID of a customer record if the record has been processed.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/GetMatchIdOutput'
examples:
GetMatchId200Example:
summary: Default GetMatchId 200 response
x-microcks-default: true
value:
matchId: example-id-12345
'480':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
examples:
GetMatchId480Example:
summary: Default GetMatchId 480 response
x-microcks-default: true
value: {}
'481':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
examples:
GetMatchId481Example:
summary: Default GetMatchId 481 response
x-microcks-default: true
value: {}
'482':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
examples:
GetMatchId482Example:
summary: Default GetMatchId 482 response
x-microcks-default: true
value: {}
'483':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
examples:
GetMatchId483Example:
summary: Default GetMatchId 483 response
x-microcks-default: true
value: {}
'484':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
examples:
GetMatchId484Example:
summary: Default GetMatchId 484 response
x-microcks-default: true
value: {}
parameters:
- name: workflowName
in: path
required: true
description: The name of the workflow.
schema:
type: string
pattern: ^[a-zA-Z_0-9-]*$
minLength: 0
maxLength: 255
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- record
properties:
record:
description: The record to fetch the Match ID for.
type: object
additionalProperties:
$ref: '#/components/schemas/RecordAttributeMapValueString'
examples:
GetMatchIdRequestExample:
summary: Default GetMatchId request
x-microcks-default: true
value:
record: {}
summary: Amazon Entity Resolution GetMatchId
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Matchingworkflows
/matchingworkflows/{workflowName}/jobs/{jobId}:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
get:
operationId: GetMatchingJob
description: Gets the status, metrics, and errors (if there are any) that are associated with a job.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/GetMatchingJobOutput'
examples:
GetMatchingJob200Example:
summary: Default GetMatchingJob 200 response
x-microcks-default: true
value:
endTime: '2025-01-15T00:00:00Z'
errorDetails: example
jobId: example-id-12345
metrics: example
startTime: '2025-01-15T00:00:00Z'
'480':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
examples:
GetMatchingJob480Example:
summary: Default GetMatchingJob 480 response
x-microcks-default: true
value: {}
'481':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
examples:
GetMatchingJob481Example:
summary: Default GetMatchingJob 481 response
x-microcks-default: true
value: {}
'482':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
examples:
GetMatchingJob482Example:
summary: Default GetMatchingJob 482 response
x-microcks-default: true
value: {}
'483':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
examples:
GetMatchingJob483Example:
summary: Default GetMatchingJob 483 response
x-microcks-default: true
value: {}
'484':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
examples:
GetMatchingJob484Example:
summary: Default GetMatchingJob 484 response
x-microcks-default: true
value: {}
parameters:
- name: jobId
in: path
required: true
description: The ID of the job.
schema:
type: string
pattern: ^[a-f0-9]{32}$
- name: workflowName
in: path
required: true
description: The name of the workflow.
schema:
type: string
pattern: ^[a-zA-Z_0-9-]*$
minLength: 0
maxLength: 255
summary: Amazon Entity Resolution GetMatchingJob
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Matchingworkflows
/matchingworkflows/{workflowName}/jobs:
parameters:
- $ref: '#/components/parameters/X-Amz-Content-Sha256'
- $ref: '#/components/parameters/X-Amz-Date'
- $ref: '#/components/parameters/X-Amz-Algorithm'
- $ref: '#/components/parameters/X-Amz-Credential'
- $ref: '#/components/parameters/X-Amz-Security-Token'
- $ref: '#/components/parameters/X-Amz-Signature'
- $ref: '#/components/parameters/X-Amz-SignedHeaders'
get:
operationId: ListMatchingJobs
description: Lists all jobs for a given workflow.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/ListMatchingJobsOutput'
examples:
ListMatchingJobs200Example:
summary: Default ListMatchingJobs 200 response
x-microcks-default: true
value:
jobs: example
nextToken: example
'480':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
examples:
ListMatchingJobs480Example:
summary: Default ListMatchingJobs 480 response
x-microcks-default: true
value: {}
'481':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
examples:
ListMatchingJobs481Example:
summary: Default ListMatchingJobs 481 response
x-microcks-default: true
value: {}
'482':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
examples:
ListMatchingJobs482Example:
summary: Default ListMatchingJobs 482 response
x-microcks-default: true
value: {}
'483':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
examples:
ListMatchingJobs483Example:
summary: Default ListMatchingJobs 483 response
x-microcks-default: true
value: {}
'484':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
examples:
ListMatchingJobs484Example:
summary: Default ListMatchingJobs 484 response
x-microcks-default: true
value: {}
parameters:
- name: maxResults
in: query
required: false
description: The maximum number of objects returned per page.
schema:
type: integer
minimum: 1
maximum: 25
- name: nextToken
in: query
required: false
description: The pagination token from the previous ListSchemaMappings API call.
schema:
type: string
pattern: ^[a-zA-Z_0-9-=+/]*$
minLength: 1
maxLength: 1024
- name: workflowName
in: path
required: true
description: The name of the workflow to be retrieved.
schema:
type: string
pattern: ^[a-zA-Z_0-9-]*$
minLength: 0
maxLength: 255
summary: Amazon Entity Resolution ListMatchingJobs
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Matchingworkflows
post:
operationId: StartMatchingJob
description: Starts the MatchingJob of a workflow. The workflow must have previously been created using the CreateMatchingWorkflow endpoint.
responses:
'200':
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/StartMatchingJobOutput'
examples:
StartMatchingJob200Example:
summary: Default StartMatchingJob 200 response
x-microcks-default: true
value:
jobId: example-id-12345
'480':
description: ThrottlingException
content:
application/json:
schema:
$ref: '#/components/schemas/ThrottlingException'
examples:
StartMatchingJob480Example:
summary: Default StartMatchingJob 480 response
x-microcks-default: true
value: {}
'481':
description: InternalServerException
content:
application/json:
schema:
$ref: '#/components/schemas/InternalServerException'
examples:
StartMatchingJob481Example:
summary: Default StartMatchingJob 481 response
x-microcks-default: true
value: {}
'482':
description: ResourceNotFoundException
content:
application/json:
schema:
$ref: '#/components/schemas/ResourceNotFoundException'
examples:
StartMatchingJob482Example:
summary: Default StartMatchingJob 482 response
x-microcks-default: true
value: {}
'483':
description: AccessDeniedException
content:
application/json:
schema:
$ref: '#/components/schemas/AccessDeniedException'
examples:
StartMatchingJob483Example:
summary: Default StartMatchingJob 483 response
x-microcks-default: true
value: {}
'484':
description: ExceedsLimitException
content:
application/json:
schema:
$ref: '#/components/schemas/ExceedsLimitException'
examples:
StartMatchingJob484Example:
summary: Default StartMatchingJob 484 response
x-microcks-default: true
value: {}
'485':
description: ConflictException
content:
application/json:
schema:
$ref: '#/components/schemas/ConflictException'
examples:
StartMatchingJob485Example:
summary: Default StartMatchingJob 485 response
x-microcks-default: true
value: {}
'486':
description: ValidationException
content:
application/json:
schema:
$ref: '#/components/schemas/ValidationException'
examples:
StartMatchingJob486Example:
summary: Default StartMatchingJob 486 response
x-microcks-default: true
value: {}
parameters:
- name: workflowName
in: path
required: true
description: The name of the matching job to be retrieved.
schema:
type: string
pattern: ^[a-zA-Z_0-9-]*$
minLength: 0
maxLength: 255
summary: Amazon Entity Resolution StartMatchingJob
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Matchingworkflows
components:
parameters:
X-Amz-Signature:
name: X-Amz-Signature
in: header
schema:
type: string
required: false
X-Amz-Content-Sha256:
name: X-Amz-Content-Sha256
in: header
schema:
type: string
required: false
X-Amz-Algorithm:
name: X-Amz-Algorithm
in: header
schema:
type: string
required: false
X-Amz-Security-Token:
name: X-Amz-Security-Token
in: header
schema:
type: string
required: false
X-Amz-SignedHeaders:
name: X-Amz-SignedHeaders
in: header
schema:
type: string
required: false
X-Amz-Credential:
name: X-Amz-Credential
in: header
schema:
type: string
required: false
X-Amz-Date:
name: X-Amz-Date
in: header
schema:
type: string
required: false
schemas:
IncrementalRunType:
type: string
enum:
- IMMEDIATE
GetMatchIdOutput:
type: object
properties:
matchId:
allOf:
- $ref: '#/components/schemas/String'
- description: The unique identifiers for this group of match records.
ResolutionTechniques:
type: object
properties:
resolutionType:
allOf:
- $ref: '#/components/schemas/ResolutionType'
- description: 'There are two types of matching, RULE_MATCHING and ML_MATCHING '
ruleBasedProperties:
allOf:
- $ref: '#/components/schemas/RuleBasedProperties'
- description: An object which defines the list of matching rules to run and has a field Rules, which is a list of rule objects.
description: 'An object which defines the resolutionType and the ruleBasedProperties '
AccessDeniedException: {}
ExceedsLimitException: {}
Integer:
type: integer
DeleteMatchingWorkflowOutput:
type: object
required:
- message
properties:
message:
allOf:
- $ref: '#/components/schemas/String'
- description: A successful operation message.
ListMatchingJobsOutput:
type: object
properties:
jobs:
allOf:
- $ref: '#/components/schemas/JobList'
- description: A list of JobSummary objects, each of which contain the ID, status, start time, and end time of a job.
nextToken:
allOf:
- $ref: '#/components/schemas/NextToken'
- description: The pagination token from the previous ListSchemaMappings API call.
RecordAttributeMapValueString:
type: string
pattern: ^[a-zA-Z_0-9-.@ ()+\t]*$
minLength: 0
maxLength: 255
CreateMatchingWorkflowOutput:
type: object
required:
- inputSourceConfig
- outputSourceConfig
- resolutionTechniques
- roleArn
- workflowArn
- workflowName
properties:
description:
allOf:
- $ref: '#/components/schemas/Description'
- description: A description of the workflow.
incrementalRunConfig:
allOf:
- $ref: '#/components/schemas/IncrementalRunConfig'
- description: An object which defines an incremental run type and has only incrementalRunType as a field.
inputSourceConfig:
allOf:
- $ref: '#/components/schemas/InputSourceConfig'
- description: A list of InputSource objects, which have the fields InputSourceARN and SchemaName.
outputSourceConfig:
allOf:
- $ref: '#/components/schemas/OutputSourceConfig'
- description: A list of OutputSource objects, each of which contains fields OutputS3Path, ApplyNormalization, and Output.
resolutionTechniques:
allOf:
- $ref: '#/components/schemas/ResolutionTechniques'
- description: 'An object which defines the resolutionType and the ruleBasedProperties '
roleArn:
allOf:
- $ref: '#/components/schemas/String'
- description: The Amazon Resource Name (ARN) of the IAM role. AWS Entity Resolution assumes this role to create resources on your behalf as part of workflow execution.
workflowArn:
allOf:
- $ref: '#/components/schemas/MatchingWorkflowArn'
- description: The ARN (Amazon Resource Name) that Entity Resolution generated for the MatchingWorkflow.
workflowName:
allOf:
- $ref: '#/components/schemas/EntityName'
- description: The name of the workflow.
ThrottlingException: {}
Boolean:
type: boolean
OutputSource:
type: object
required:
- output
- outputS3Path
properties:
KMSArn:
allOf:
- $ref: '#/components/schemas/KMSArn'
- description: Customer KMS ARN for encryption at rest. If not provided, system will use an Entity Resolution managed KMS key.
applyNormalization:
allOf:
- $ref: '#/components/schemas/Boolean'
- description: 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, Entity Resolution will normalize this field in the output to (123)-456-7890.
output:
allOf:
- $ref: '#/components/schemas/OutputSourceOutputList'
- description: A list of OutputAttribute objects, each of which have the fields Name and Hashed. Each of these objects selects a column to be included in the output table, and whether the values of the column should be hashed.
outputS3Path:
allOf:
- $ref: '#/components/schemas/OutputSourceOutputS3PathString'
- description: The S3 path to which Entity Resolution will write the output table.
description: A list of OutputAttribute objects, each of which have the fields Name and Hashed. Each of these objects selects a column to be included in the output table, and whether the values of the column should be hashed.
ConflictException: {}
Rule:
type: object
required:
- matchingKeys
- ruleName
properties:
matchingKeys:
allOf:
- $ref: '#/components/schemas/RuleMatchingKeysList'
- description: A list of MatchingKeys. The MatchingKeys must have been defined in the SchemaMapping. Two records are considered to match according to this rule if all of the MatchingKeys match.
ruleName:
allOf:
- $ref: '#/components/schemas/RuleRuleNameString'
- description: A name for the matching rule.
description: An object containing RuleName, and MatchingKeys.
Timestamp:
type: string
format: date-time
OutputAttribute:
type: object
required:
- name
properties:
hashed:
allOf:
- $ref: '#/components/schemas/Boolean'
- description: Enables the ability to hash the column values in the output.
name:
allOf:
- $ref: '#/components/schemas/AttributeName'
- description: A name of a column to be written to the output. This must be an InputField name in the schema mapping.
description: A list of OutputAttribute objects, each of which have the fields Name and Hashed. Each of these objects selects a column to be included in the output table, and whether the values of the column should be hashed.
IncrementalRunConfig:
type: object
properties:
incrementalRunType:
allOf:
- $ref: '#/components/schemas/IncrementalRunType'
- description: 'The type of incremental run. It takes only one value: IMMEDIATE.'
description: An object which defines an incremental run type and has only incrementalRunType as a field.
ListMatchingWorkflowsOutput:
type: object
properties:
nextToken:
allOf:
- $ref: '#/components/schemas/NextToken'
- description: The pagination token from the previous ListSchemaMappings API call.
workflowSummaries:
allOf:
- $ref: '#/components/schemas/MatchingWorkflowList'
- description: A list of MatchingWorkflowSummary objects, each of which contain the fields WorkflowName, WorkflowArn, CreatedAt, and UpdatedAt.
ResolutionType:
type: string
enum:
- RULE_MATCHING
- ML_MATCHING
TagMap:
type: object
minProperties: 0
maxProperties: 200
additionalProperties:
$ref: '#/components/schemas/TagValue'
OutputSourceConfig:
type: array
items:
$ref: '#/components/schemas/OutputSource'
minItems: 1
maxItems: 1
MatchingWorkflowList:
type: array
items:
$ref: '#/components/schemas/MatchingWorkflowSummary'
ErrorDetails:
type: object
properties:
errorMessage:
allOf:
- $ref: '#/components/schemas/ErrorMessage'
- description: The error message from the job, if there is one.
description: An object containing an error message, if there was an error.
InputSourceInputSourceARNString:
type: string
pattern: ^arn:aws:.*:.*:[0-9]+:.*$
RuleBasedPropertiesRulesList:
type: array
items:
$ref: '#/components/schemas/Rule'
minItems: 1
maxItems: 15
JobList:
type: array
items:
$ref: '#/components/schemas/JobSummary'
String:
type: string
NextToken:
type: string
pattern: ^[a-zA-Z_0-9-=+/]*$
minLength: 1
maxLength: 1024
InputSource:
type: object
required:
- inputSourceARN
- schemaName
properties:
applyNormalization:
allOf:
- $ref: '#/components/schemas/Boolean'
- description: 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, Entity Resolution will normalize this field in the output to (123)-456-7890.
inputSourceARN:
allOf:
- $ref: '#/components/schemas/InputSourceInputSourceARNString'
- description: An Glue table ARN for the input source table.
schemaName:
allOf:
- $ref: '#/components/schemas/EntityName'
- description: The name of the schema to be retrieved.
description: An object containing InputSourceARN, SchemaName, and ApplyNormalization.
RuleBasedProperties:
type: object
required:
- attributeMatchingModel
- rules
properties:
attributeMatchingModel:
allOf:
- $ref: '#/components/schemas/AttributeMatchingModel'
- description: You can either choose ONE_TO_ONE or MANY_TO_MANY as the AttributeMatchingModel. When choosing MANY_TO_MANY, the system can match attribute across the sub-types of an attribute type. For example, if the value of the Email field of Profile A and the value of BusinessEmail field of Profile B matches, the two profiles are matched on the Email type. When choosing ONE_TO_ONE the system can only match if the sub-types are exact matches. For example, only when the value of the Email field of Profile A and the value of the Email field of Profile B matches, the two profiles are matched on the Email type.
rules:
allOf:
- $ref: '#/components/schemas/RuleBasedPropertiesRulesList'
- description: A list of Rule objects, each of which have fields RuleName and MatchingKeys.
description: An object which defines the list of matching rules to run and has a field Rules, which is a list of rule objects.
UpdateMatchingWorkflowOutput:
type: object
required:
- inputSourceConfig
- outputSourceConfig
- resolutionTechniques
- roleArn
- workflowName
properties:
description:
allOf:
- $ref: '#/components/schemas/Description'
- description: A description of the workflow.
incrementalRunConfig:
allOf:
- $ref: '#/components/schemas/IncrementalRunConfig'
- description: An object which defines an incremental run type and has only incrementalRunType as a field.
inputSourceConfig:
allOf:
- $ref: '#/components/schemas/InputSourceConfig'
- description: A list of InputSource objects, which have the fields InputSourceARN and SchemaName.
outputSourceConfig:
allOf:
- $ref: '#/components/schemas/OutputSourceConfig'
- description: A list of OutputSource objects, each of which contains fields OutputS3Path, ApplyNormalization, and Output.
resolutionTechniques:
allOf:
- $ref: '#/components/schemas/ResolutionTechniques'
- description: 'An object which defines the resolutionType and the ruleBasedProperties '
roleArn:
allOf:
- $ref: '#/components/schemas/String'
- description: The Amazon Resource Name (ARN) of the IAM role. AWS Entity Resolution assumes this role to create resources on your behalf as part of workflow execution.
workflowName:
allOf:
- $ref: '#/components/schemas/EntityName'
- description: The name of the workflow.
InternalServerException: {}
RuleMatchingKeysList:
type: array
items:
$ref: '#/components/schemas/AttributeName'
minItems: 1
maxItems: 15
JobId:
type: string
pattern: ^[a-f0-9]{32}$
AttributeName:
type: string
pattern: ^[a-zA-Z_0-9- \t]*$
minLength: 0
maxLength: 255
GetMatchingJobOutput:
type: object
required:
- jobId
- startTime
- status
properties:
endTime:
allOf:
- $ref: '#/components/schemas/Timestamp'
- description: The time at which the job has finished.
errorDetails:
allOf:
- $ref: '#/components/schemas/ErrorDetails'
- description: An object containing an error message, if there was an error.
jobId:
allOf:
- $ref: '#/components/schemas/JobId'
- description: The ID of the job.
metrics:
allOf:
- $ref: '#/components/schemas/JobMetrics'
- description: Metrics associated with the execution, specifically total records processed, unique IDs generated, and records the execution skipped.
startTime:
allOf:
- $ref: '#/components/schemas/Timestamp'
- description: The time at which the job was started.
status:
allOf:
- $ref: '#/components/schemas/JobStatus'
- description: The current status of the job. Either running, succeeded, queued, or failed.
JobStatus:
type: string
enum:
- RUNNING
- SUCCEEDED
- FAILED
- QUEUED
InputSourceConfig:
type: array
items:
$ref: '#/components/schemas/InputSource'
minItems: 1
maxItems: 20
ErrorMessage:
type: string
minLength: 1
maxLength: 2048
MatchingWorkflowSummary:
type: object
required:
- createdAt
- updatedAt
- workflowArn
- workflowName
properties:
createdAt:
allOf:
- $ref: '#/components/schemas/Timestamp'
- description: The timestamp of when the workflow was created.
updatedAt:
allOf:
- $ref: '#/components/schemas/Timestamp'
- description: The timestamp of when the workflow was last updated.
workflowArn:
allOf:
- $ref: '#/components/schemas/MatchingWorkflowArn'
- description: The ARN (Amazon Resource Name) that Entity Resolution generated for the MatchingWorkflow.
workflowName:
allOf:
- $ref: '#/components/schemas/EntityName'
- description: The name of the workflow.
description: A list of MatchingWorkflowSummary objects, each of which contain the fields WorkflowName, WorkflowArn, CreatedAt, UpdatedAt.
Description:
type: string
minLength: 0
maxLength: 255
JobSummary:
type: object
required:
- jobId
- startTime
- status
properties:
endTime:
allOf:
- $ref: '#/components/schemas/Timestamp'
- description: The time at which the job has finished.
jobId:
allOf:
- $ref: '#/components/schemas/JobId'
- description: The ID of the job.
startTime:
allOf:
- $ref: '#/components/schemas/Timestamp'
- description: The time at which the job was started.
status:
allOf:
- $ref: '#/components/schemas/JobStatus'
- description: The current status of the job. Either running, succeeded, queued, or failed.
description: An object containing the JobId, Status, StartTime, and EndTime of a job.
ResourceNotFoundException: {}
MatchingWorkflowArn:
type: string
pattern: ^arn:(aws|aws-us-gov|aws-cn):entityresolution:.*:[0-9]+:(matchingworkflow/.*)$
KMSArn:
type: string
pattern: ^arn:aws:kms:.*:[0-9]+:.*$
JobMetrics:
type: object
properties:
inputRecords:
allOf:
- $ref: '#/components/schemas/Integer'
- description: The total number of input records.
matchIDs:
allOf:
- $ref: '#/components/schemas/Integer'
- description: The total number of matchIDs generated.
recordsNotProcessed:
allOf:
- $ref: '#/components/schemas/Integer'
- description: The total number of records that did not get processed,
totalRecordsProcessed:
allOf:
- $ref: '#/components/schemas/Integer'
- description: The total number of records processed.
description: An object containing InputRecords, TotalRecordsProcessed, MatchIDs, and RecordsNotProcessed.
GetMatchingWorkflowOutput:
type: object
required:
- createdAt
- inputSourceConfig
- outputSourceConfig
- resolutionTechniques
- roleArn
- updatedAt
- workflowArn
- workflowName
properties:
createdAt:
allOf:
- $ref: '#/components/schemas/Timestamp'
- description: The timestamp of when the workflow was created.
description:
allOf:
- $ref: '#/components/schemas/Description'
- description: A description of the workflow.
incrementalRunConfig:
allOf:
- $ref: '#/components/schemas/IncrementalRunConfig'
- description: An object which defines an incremental run type and has only incrementalRunType as a field.
inputSourceConfig:
allOf:
- $ref: '#/components/schemas/InputSourceConfig'
- description: A list of InputSource objects, which have the fields InputSourceARN and SchemaName.
outputSourceConfig:
allOf:
- $ref: '#/components/schemas/OutputSourceConfig'
- description: A list of OutputSource objects, each of which contains fields OutputS3Path, ApplyNormalization, and Output.
resolutionTechniques:
allOf:
- $ref: '#/components/schemas/ResolutionTechniques'
- description: 'An object which defines the resolutionType and the ruleBasedProperties '
roleArn:
allOf:
- $ref: '#/components/schemas/String'
- description: The Amazon Resource Name (ARN) of the IAM role. AWS Entity Resolution assumes this role to access resources on your behalf.
tags:
allOf:
- $ref: '#/components/schemas/TagMap'
- description: The tags used to organize, track, or control access for this resource.
updatedAt:
allOf:
- $ref: '#/components/schemas/Timestamp'
- description: The timestamp of when the workflow was last updated.
workflowArn:
allOf:
- $ref: '#/components/schemas/MatchingWorkflowArn'
- description: The ARN (Amazon Resource Name) that Entity Resolution generated for the MatchingWorkflow.
workflowName:
allOf:
- $ref: '#/components/schemas/EntityName'
- description: The name of the workflow.
EntityName:
type: string
pattern: ^[a-zA-Z_0-9-]*$
minLength: 0
maxLength: 255
ValidationException: {}
AttributeMatchingModel:
type: string
enum:
- ONE_TO_ONE
- MANY_TO_MANY
OutputSourceOutputS3PathString:
type: string
pattern: ^s3://([^/]+)/?(.*?([^/]+)/?)$
RuleRuleNameString:
type: string
pattern: ^[a-zA-Z_0-9- \t]*$
minLength: 0
maxLength: 255
StartMatchingJobOutput:
type: object
required:
- jobId
properties:
jobId:
allOf:
- $ref: '#/components/schemas/JobId'
- description: The ID of the job.
OutputSourceOutputList:
type: array
items:
$ref: '#/components/schemas/OutputAttribute'
minItems: 0
maxItems: 750
TagValue:
type: string
minLength: 0
maxLength: 256
securitySchemes:
hmac:
type: apiKey
name: Authorization
in: header
description: Amazon Signature authorization v4
x-amazon-apigateway-authtype: awsSigv4
externalDocs:
description: Amazon Web Services documentation
url: https://docs.aws.amazon.com/entityresolution/
x-hasEquivalentPaths: true