reidentificationJob

Get all re-identification jobs

Securityapi_key
Request
query Parameters
page_number
integer <int64>
Default: 1

The page number for which to get re-identification jobs. This will default to the first page if excluded

page_size
integer <int64>

The maximum number of objects to return. This will default to the DefaultApiPageSize setting if not provided

environment_id
integer <int32>

The ID of the environment to get all re-identification jobs from

Responses
200

Success

400

Bad request

403

Forbidden access

404

Not found

get/reidentification-jobs
Response samples
application/json
{
  • "_pageInfo": {
    },
  • "responseList": [
    ]
}

Create re-identification job

Securityapi_key
Request
Request Body schema: application/json
required

The re-identification job to create

jobName
required
string <= 255 characters

The name of the re-identification job. Once the re-identification job is created, this field cannot be changed.

rulesetId
required
integer <int32>

The ID of the ruleset that this re-identification job is based on. Once the re-identification job is created, the underlying environment that is inferred from the ruleset will be unchangeable. That is, the job can only be updated to reference a ruleset that is in the same environment as the environment of the original ruleset.

email
string

The email address to send job status notifications to; note that the SMTP settings must be configured first to receive notifications.

feedbackSize
integer <int32> >= 1

The granularity with which the Masking Engine provides updates on the progress of the re-identification job. For instance, a feedbackSize of 50000 results in log updates whenever 50000 rows are processed during the masking phase.

jobDescription
string <= 255 characters

A description of the job.

maxMemory
integer <int32>

The maximum amount of memory, in MB, that the re-identification job can consume during execution.

minMemory
integer <int32>

The minimum amount of memory, in MB, that the re-identification job can consume during execution.

multiTenant
boolean
Default: false

This field determines whether the re-identification job, after creation, can be executed using a connector that is different from the underlying connector associated with the ruleset that this re-identification job is based on.

numInputStreams
integer <int32> >= 1
Default: 1

This field controls the amount of parallelism that the re-identification job uses to extract out the data to be masked. For instance, when masking a database, specifying 5 input streams results in the re-identification job reading up to 5 database tables in parallel and then masking those 5 streams of data in parallel. The higher the value of this field, the more potential parallelism there will be in the job, but the re-identification job will consume more memory. If the number of input streams exceeds the number of units being masked (e.g. tables or files), then the excess streams will do nothing.

onTheFlyMasking
boolean
Default: false

This field determines whether the re-identification job will be performed InPlace or OnTheFly. The process for InPlace masking is to read out the data to be masked, mask the data, and then load the masked data back into the original data source. The process for OnTheFly masking is to read out the data to be masked, mask the data, and then load the masked data back into a different data source. When masking OnTheFly, the field 'onTheFlyMaskingSource' must be provided.

object (DatabaseMaskingOptions)
object (OnTheFlyMaskingSource)
failImmediately
boolean
Default: false

This field determines whether the masking job will fail immediately or delay failure until job completion when a masking algorithm fails to mask its data. Setting this value to 'false' provides a means for a user to see all cumulative masking errors before the job is marked as failed.

Array of objects (JobTask)

This field determines what tasks to perform before/after a job from a set of available driver support tasks as indicated by the chosen target ruleset/connector.

streamRowLimit
integer >= -1

This value constrains the total number of rows that may enter the job for each masking stream. A setting of 0 means unlimited. A value of -1 selects the default value. The default value for this setting varies by job type. The minimum explicit value allowed is 20

Responses
201

Success

400

Bad request

403

Forbidden access

404

Not found

409

Conflict

post/reidentification-jobs
Request samples
application/json
{
  • "jobName": "some_reidentification_job",
  • "rulesetId": 7,
  • "jobDescription": "This example illustrates a ReidentificationJob with just a handful of the possible fields set. It is meant to exemplify a simple JSON body that can be passed to the endpoint to create a ReidentificationJob.",
  • "feedbackSize": 100000,
  • "onTheFlyMasking": false,
  • "databaseMaskingOptions": {
    }
}
Response samples
application/json
{
  • "jobName": "some_reidentification_job",
  • "rulesetId": 7,
  • "jobDescription": "This example illustrates a ReidentificationJob with just a handful of the possible fields set. It is meant to exemplify a simple JSON body that can be passed to the endpoint to create a ReidentificationJob.",
  • "feedbackSize": 100000,
  • "onTheFlyMasking": false,
  • "databaseMaskingOptions": {
    }
}

Get re-identification job by ID

Securityapi_key
Request
path Parameters
reidentificationJobId
required
integer <int32>

The ID of the re-identification job to get

Responses
200

Success

400

Bad request

403

Forbidden access

404

Not found

get/reidentification-jobs/{reidentificationJobId}
Response samples
application/json
{
  • "jobName": "some_reidentification_job",
  • "rulesetId": 7,
  • "jobDescription": "This example illustrates a ReidentificationJob with just a handful of the possible fields set. It is meant to exemplify a simple JSON body that can be passed to the endpoint to create a ReidentificationJob.",
  • "feedbackSize": 100000,
  • "onTheFlyMasking": false,
  • "databaseMaskingOptions": {
    }
}

Update re-identification job by ID

Securityapi_key
Request
path Parameters
reidentificationJobId
required
integer <int32>

The ID of the re-identification job to update

Request Body schema: application/json
required

The updated re-identification job

jobName
required
string <= 255 characters

The name of the re-identification job. Once the re-identification job is created, this field cannot be changed.

rulesetId
required
integer <int32>

The ID of the ruleset that this re-identification job is based on. Once the re-identification job is created, the underlying environment that is inferred from the ruleset will be unchangeable. That is, the job can only be updated to reference a ruleset that is in the same environment as the environment of the original ruleset.

email
string

The email address to send job status notifications to; note that the SMTP settings must be configured first to receive notifications.

feedbackSize
integer <int32> >= 1

The granularity with which the Masking Engine provides updates on the progress of the re-identification job. For instance, a feedbackSize of 50000 results in log updates whenever 50000 rows are processed during the masking phase.

jobDescription
string <= 255 characters

A description of the job.

maxMemory
integer <int32>

The maximum amount of memory, in MB, that the re-identification job can consume during execution.

minMemory
integer <int32>

The minimum amount of memory, in MB, that the re-identification job can consume during execution.

multiTenant
boolean
Default: false

This field determines whether the re-identification job, after creation, can be executed using a connector that is different from the underlying connector associated with the ruleset that this re-identification job is based on.

numInputStreams
integer <int32> >= 1
Default: 1

This field controls the amount of parallelism that the re-identification job uses to extract out the data to be masked. For instance, when masking a database, specifying 5 input streams results in the re-identification job reading up to 5 database tables in parallel and then masking those 5 streams of data in parallel. The higher the value of this field, the more potential parallelism there will be in the job, but the re-identification job will consume more memory. If the number of input streams exceeds the number of units being masked (e.g. tables or files), then the excess streams will do nothing.

onTheFlyMasking
boolean
Default: false

This field determines whether the re-identification job will be performed InPlace or OnTheFly. The process for InPlace masking is to read out the data to be masked, mask the data, and then load the masked data back into the original data source. The process for OnTheFly masking is to read out the data to be masked, mask the data, and then load the masked data back into a different data source. When masking OnTheFly, the field 'onTheFlyMaskingSource' must be provided.

object (DatabaseMaskingOptions)
object (OnTheFlyMaskingSource)
failImmediately
boolean
Default: false

This field determines whether the masking job will fail immediately or delay failure until job completion when a masking algorithm fails to mask its data. Setting this value to 'false' provides a means for a user to see all cumulative masking errors before the job is marked as failed.

Array of objects (JobTask)

This field determines what tasks to perform before/after a job from a set of available driver support tasks as indicated by the chosen target ruleset/connector.

streamRowLimit
integer >= -1

This value constrains the total number of rows that may enter the job for each masking stream. A setting of 0 means unlimited. A value of -1 selects the default value. The default value for this setting varies by job type. The minimum explicit value allowed is 20

Responses
200

Success

400

Bad request

403

Forbidden access

404

Not found

put/reidentification-jobs/{reidentificationJobId}
Request samples
application/json
{
  • "jobName": "some_reidentification_job",
  • "rulesetId": 7,
  • "jobDescription": "This example illustrates a ReidentificationJob with just a handful of the possible fields set. It is meant to exemplify a simple JSON body that can be passed to the endpoint to create a ReidentificationJob.",
  • "feedbackSize": 100000,
  • "onTheFlyMasking": false,
  • "databaseMaskingOptions": {
    }
}
Response samples
application/json
{
  • "jobName": "some_reidentification_job",
  • "rulesetId": 7,
  • "jobDescription": "This example illustrates a ReidentificationJob with just a handful of the possible fields set. It is meant to exemplify a simple JSON body that can be passed to the endpoint to create a ReidentificationJob.",
  • "feedbackSize": 100000,
  • "onTheFlyMasking": false,
  • "databaseMaskingOptions": {
    }
}

Delete re-identification job by ID

Securityapi_key
Request
path Parameters
reidentificationJobId
required
integer <int32>

The ID of the re-identification job to delete

Responses
200

Success

400

Bad request

403

Forbidden access

404

Not found

delete/reidentification-jobs/{reidentificationJobId}
➔ Next to role