list_identity_resolution_jobs

list_identity_resolution_jobs(**kwargs)

Lists all of the Identity Resolution Jobs in your domain. The response sorts the list by JobStartTime .

See also: AWS API Documentation

Request Syntax

response = client.list_identity_resolution_jobs(
    DomainName='string',
    NextToken='string',
    MaxResults=123
)

Parameters

• DomainName (string) --

  [REQUIRED]

  The unique name of the domain.

• NextToken (string) -- The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results.
• MaxResults (integer) -- The maximum number of results to return per page.

Return type

dict

Returns

Response Syntax

{
    'IdentityResolutionJobsList': [
        {
            'DomainName': 'string',
            'JobId': 'string',
            'Status': 'PENDING'|'PREPROCESSING'|'FIND_MATCHING'|'MERGING'|'COMPLETED'|'PARTIAL_SUCCESS'|'FAILED',
            'JobStartTime': datetime(2015, 1, 1),
            'JobEndTime': datetime(2015, 1, 1),
            'JobStats': {
                'NumberOfProfilesReviewed': 123,
                'NumberOfMatchesFound': 123,
                'NumberOfMergesDone': 123
            },
            'ExportingLocation': {
                'S3Exporting': {
                    'S3BucketName': 'string',
                    'S3KeyName': 'string'
                }
            },
            'Message': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

• (dict) --

  • IdentityResolutionJobsList (list) --

    A list of Identity Resolution Jobs.

    • (dict) --

      Information about the Identity Resolution Job.

      • 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.

      • JobStartTime (datetime) --

        The timestamp of when the job was started or will be started.

      • JobEndTime (datetime) --

        The timestamp of when the job was completed.

      • JobStats (dict) --

        Statistics about an Identity Resolution Job.

        • NumberOfProfilesReviewed (integer) --

          The number of profiles reviewed.

        • NumberOfMatchesFound (integer) --

          The number of matches found.

        • NumberOfMergesDone (integer) --

          The number of merges completed.

      • 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.

      • Message (string) --

        The error messages that are generated when the Identity Resolution Job runs.

  • NextToken (string) --

    If there are additional results, this is the token for the next set of results.

Exceptions

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