VoiceID / Client / describe_fraudster_registration_job

describe_fraudster_registration_job#

VoiceID.Client.describe_fraudster_registration_job(**kwargs)#

Describes the specified fraudster registration job.

See also: AWS API Documentation

Request Syntax

response = client.describe_fraudster_registration_job(
    DomainId='string',
    JobId='string'
)
Parameters:
  • DomainId (string) –

    [REQUIRED]

    The identifier of the domain that contains the fraudster registration job.

  • JobId (string) –

    [REQUIRED]

    The identifier of the fraudster registration job you are describing.

Return type:

dict

Returns:

Response Syntax

{
    'Job': {
        'CreatedAt': datetime(2015, 1, 1),
        'DataAccessRoleArn': 'string',
        'DomainId': 'string',
        'EndedAt': datetime(2015, 1, 1),
        'FailureDetails': {
            'Message': 'string',
            'StatusCode': 123
        },
        'InputDataConfig': {
            'S3Uri': 'string'
        },
        'JobId': 'string',
        'JobName': 'string',
        'JobProgress': {
            'PercentComplete': 123
        },
        'JobStatus': 'SUBMITTED'|'IN_PROGRESS'|'COMPLETED'|'COMPLETED_WITH_ERRORS'|'FAILED',
        'OutputDataConfig': {
            'KmsKeyId': 'string',
            'S3Uri': 'string'
        },
        'RegistrationConfig': {
            'DuplicateRegistrationAction': 'SKIP'|'REGISTER_AS_NEW',
            'FraudsterSimilarityThreshold': 123,
            'WatchlistIds': [
                'string',
            ]
        }
    }
}

Response Structure

  • (dict) –

    • Job (dict) –

      Contains details about the specified fraudster registration job.

      • CreatedAt (datetime) –

        A timestamp of when the fraudster registration job was created.

      • DataAccessRoleArn (string) –

        The IAM role Amazon Resource Name (ARN) that grants Voice ID permissions to access customer’s buckets to read the input manifest file and write the job output file.

      • DomainId (string) –

        The identifier of the domain that contains the fraudster registration job.

      • EndedAt (datetime) –

        A timestamp of when the fraudster registration job ended.

      • FailureDetails (dict) –

        Contains details that are populated when an entire batch job fails. In cases of individual registration job failures, the batch job as a whole doesn’t fail; it is completed with a JobStatus of COMPLETED_WITH_ERRORS. You can use the job output file to identify the individual registration requests that failed.

        • Message (string) –

          A description of the error that caused the batch job failure.

        • StatusCode (integer) –

          An HTTP status code representing the nature of the error.

      • InputDataConfig (dict) –

        The input data config containing an S3 URI for the input manifest file that contains the list of fraudster registration job requests.

        • S3Uri (string) –

          The S3 location for the input manifest file that contains the list of individual enrollment or registration job requests.

      • JobId (string) –

        The service-generated identifier for the fraudster registration job.

      • JobName (string) –

        The client-provided name for the fraudster registration job.

      • JobProgress (dict) –

        Shows the completed percentage of registration requests listed in the input file.

        • PercentComplete (integer) –

          Shows the completed percentage of enrollment or registration requests listed in the input file.

      • JobStatus (string) –

        The current status of the fraudster registration job.

      • OutputDataConfig (dict) –

        The output data config containing the S3 location where you want Voice ID to write your job output file; you must also include a KMS key ID in order to encrypt the file.

        • KmsKeyId (string) –

          The identifier of the KMS key you want Voice ID to use to encrypt the output file of a speaker enrollment job/fraudster registration job.

        • S3Uri (string) –

          The S3 path of the folder where Voice ID writes the job output file. It has a *.out extension. For example, if the input file name is input-file.json and the output folder path is s3://output-bucket/output-folder, the full output file path is s3://output-bucket/output-folder/job-Id/input-file.json.out.

      • RegistrationConfig (dict) –

        The registration config containing details such as the action to take when a duplicate fraudster is detected, and the similarity threshold to use for detecting a duplicate fraudster.

        • DuplicateRegistrationAction (string) –

          The action to take when a fraudster is identified as a duplicate. The default action is SKIP, which skips registering the duplicate fraudster. Setting the value to REGISTER_AS_NEW always registers a new fraudster into the specified domain.

        • FraudsterSimilarityThreshold (integer) –

          The minimum similarity score between the new and old fraudsters in order to consider the new fraudster a duplicate.

        • WatchlistIds (list) –

          The identifiers of watchlists that a fraudster is registered to. If a watchlist isn’t provided, the fraudsters are registered to the default watchlist.

          • (string) –

Exceptions

  • VoiceID.Client.exceptions.ResourceNotFoundException

  • VoiceID.Client.exceptions.ValidationException

  • VoiceID.Client.exceptions.InternalServerException

  • VoiceID.Client.exceptions.ThrottlingException

  • VoiceID.Client.exceptions.AccessDeniedException