get_identity_resolution_job¶

CustomerProfiles.Client.get_identity_resolution_job(**kwargs)¶

Returns information about an Identity Resolution Job in a specific domain.

Identity Resolution Jobs are set up using the Amazon Connect admin console. For more information, see Use Identity Resolution to consolidate similar profiles.

See also: AWS API Documentation

Request Syntax

response = client.get_identity_resolution_job(
    DomainName='string',
    JobId='string'
)

Parameters

DomainName (string) --
[REQUIRED]

The unique name of the domain.
JobId (string) --
[REQUIRED]

The unique identifier of the Identity Resolution Job.

Return type

dict

Returns

Response Syntax

{
    'DomainName': 'string',
    'JobId': 'string',
    'Status': 'PENDING'|'PREPROCESSING'|'FIND_MATCHING'|'MERGING'|'COMPLETED'|'PARTIAL_SUCCESS'|'FAILED',
    'Message': 'string',
    'JobStartTime': datetime(2015, 1, 1),
    'JobEndTime': datetime(2015, 1, 1),
    'LastUpdatedAt': datetime(2015, 1, 1),
    'JobExpirationTime': datetime(2015, 1, 1),
    'AutoMerging': {
        'Enabled': True|False,
        'Consolidation': {
            'MatchingAttributesList': [
                [
                    'string',
                ],
            ]
        },
        'ConflictResolution': {
            'ConflictResolvingModel': 'RECENCY'|'SOURCE',
            'SourceName': 'string'
        },
        'MinAllowedConfidenceScoreForMerging': 123.0
    },
    'ExportingLocation': {
        'S3Exporting': {
            'S3BucketName': 'string',
            'S3KeyName': 'string'
        }
    },
    'JobStats': {
        'NumberOfProfilesReviewed': 123,
        'NumberOfMatchesFound': 123,
        'NumberOfMergesDone': 123
    }
}

Response Structure

(dict) --
- DomainName (string) --
  
  The unique name of the domain.
- JobId (string) --
  
  The unique identifier of the Identity Resolution Job.
- Status (string) --
  
  The status of the Identity Resolution Job.
  - PENDING : The Identity Resolution Job is scheduled but has not started yet. If you turn off the Identity Resolution feature in your domain, jobs in the PENDING state are deleted.
  - PREPROCESSING : The Identity Resolution Job is loading your data.
  - FIND_MATCHING : The Identity Resolution Job is using the machine learning model to identify profiles that belong to the same matching group.
  - MERGING : The Identity Resolution Job is merging duplicate profiles.
  - COMPLETED : The Identity Resolution Job completed successfully.
  - PARTIAL_SUCCESS : There's a system error and not all of the data is merged. The Identity Resolution Job writes a message indicating the source of the problem.
  - FAILED : The Identity Resolution Job did not merge any data. It writes a message indicating the source of the problem.
- Message (string) --
  
  The error messages that are generated when the Identity Resolution Job runs.
- JobStartTime (datetime) --
  
  The timestamp of when the Identity Resolution Job was started or will be started.
- JobEndTime (datetime) --
  
  The timestamp of when the Identity Resolution Job was completed.
- LastUpdatedAt (datetime) --
  
  The timestamp of when the Identity Resolution Job was most recently edited.
- JobExpirationTime (datetime) --
  
  The timestamp of when the Identity Resolution Job will expire.
- AutoMerging (dict) --
  
  Configuration settings for how to perform the auto-merging of profiles.
  - Enabled (boolean) --
    
    The flag that enables the auto-merging of duplicate profiles.
  - Consolidation (dict) --
    
    A list of matching attributes that represent matching criteria. If two profiles meet at least one of the requirements in the matching attributes list, they will be merged.
    - MatchingAttributesList (list) --
      
      A list of matching criteria.
      - (list) --
        
        (string) --
  - ConflictResolution (dict) --
    
    How the auto-merging process should resolve conflicts between different profiles. For example, if Profile A and Profile B have the same FirstName and LastName (and that is the matching criteria), which EmailAddress should be used?
    - ConflictResolvingModel (string) --
      
      How the auto-merging process should resolve conflicts between different profiles.
      - RECENCY : Uses the data that was most recently updated.
      - SOURCE : Uses the data from a specific source. For example, if a company has been aquired or two departments have merged, data from the specified source is used. If two duplicate profiles are from the same source, then RECENCY is used again.
    - SourceName (string) --
      
      The ObjectType name that is used to resolve profile merging conflicts when choosing SOURCE as the ConflictResolvingModel .
  - MinAllowedConfidenceScoreForMerging (float) --
    
    A number between 0 and 1 that represents the minimum confidence score required for profiles within a matching group to be merged during the auto-merge process. A higher score means higher similarity required to merge profiles.
- ExportingLocation (dict) --
  
  The S3 location where the Identity Resolution Job writes result files.
  - S3Exporting (dict) --
    
    Information about the S3 location where Identity Resolution Jobs write result files.
    - S3BucketName (string) --
      
      The name of the S3 bucket name where Identity Resolution Jobs write result files.
    - S3KeyName (string) --
      
      The S3 key name of the location where Identity Resolution Jobs write result files.
- JobStats (dict) --
  
  Statistics about the Identity Resolution Job.
  - NumberOfProfilesReviewed (integer) --
    
    The number of profiles reviewed.
  - NumberOfMatchesFound (integer) --
    
    The number of matches found.
  - NumberOfMergesDone (integer) --
    
    The number of merges completed.

Exceptions

CustomerProfiles.Client.exceptions.BadRequestException
CustomerProfiles.Client.exceptions.ResourceNotFoundException
CustomerProfiles.Client.exceptions.AccessDeniedException
CustomerProfiles.Client.exceptions.ThrottlingException
CustomerProfiles.Client.exceptions.InternalServerException

Table Of Contents

get_identity_resolution_job¶