List

Lists DlpJobs that match the specified filter in the request

6 variables
29 variables

Lists DlpJobs that match the specified filter in the request. See https://cloud.google.com/dlp/docs/inspecting-storage and https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more

Authorization

To use this building block you will have to grant access to at least one of the following scopes:

  • View and manage your data across Google Cloud Platform services

Input

This building block consumes 6 input parameters

  = Parameter name
  = Format

parent STRING Required

The parent resource name, for example projects/my-project-id

filter STRING

Optional. Allows filtering.

Supported syntax:

  • Filter expressions are made up of one or more restrictions.
  • Restrictions can be combined by AND or OR logical operators. A sequence of restrictions implicitly uses AND.
  • A restriction has the form of <field> <operator> <value>.
  • Supported fields/values for inspect jobs:
    • state - PENDING|RUNNING|CANCELED|FINISHED|FAILED
    • inspected_storage - DATASTORE|CLOUD_STORAGE|BIGQUERY
    • trigger_name - The resource name of the trigger that created job.
    • 'end_time` - Corresponds to time the job finished.
    • 'start_time` - Corresponds to time the job finished.
  • Supported fields for risk analysis jobs:
    • state - RUNNING|CANCELED|FINISHED|FAILED
    • 'end_time` - Corresponds to time the job finished.
    • 'start_time` - Corresponds to time the job finished.
  • The operator must be = or !=.

Examples:

  • inspected_storage = cloud_storage AND state = done
  • inspected_storage = cloud_storage OR inspected_storage = bigquery
  • inspected_storage = cloud_storage AND (state = done OR state = canceled)
  • end_time > "2017-12-12T00:00:00+00:00"

The length of this field should be no more than 500 characters

pageToken STRING

The standard list page token

pageSize INTEGER

The standard list page size

orderBy STRING

Optional comma separated list of fields to order by, followed by asc or desc postfix. This list is case-insensitive, default sorting order is ascending, redundant space characters are insignificant.

Example: name asc, end_time asc, create_time desc

Supported fields are:

  • create_time: corresponds to time the job was created.
  • end_time: corresponds to time the job ended.
  • name: corresponds to job's name.
  • state: corresponds to state

type ENUMERATION

The type of job. Defaults to DlpJobType.INSPECT

Output

This building block provides 29 output parameters

  = Parameter name
  = Format

nextPageToken STRING

The standard List next-page token

jobs[] OBJECT

Combines all of the information about a DLP job

jobs[].jobTriggerName STRING

If created by a job trigger, the resource name of the trigger that instantiated the job

jobs[].createTime ANY

Time when the job was created

jobs[].state ENUMERATION

State of a job

jobs[].riskDetails OBJECT

Result of a risk analysis operation request

jobs[].riskDetails.kMapEstimationResult OBJECT

Result of the reidentifiability analysis. Note that these results are an estimation, not exact values

jobs[].riskDetails.deltaPresenceEstimationResult OBJECT

Result of the δ-presence computation. Note that these results are an estimation, not exact values

jobs[].riskDetails.lDiversityResult OBJECT

Result of the l-diversity computation

jobs[].riskDetails.requestedSourceTable OBJECT

Message defining the location of a BigQuery table. A table is uniquely identified by its project_id, dataset_id, and table_name. Within a query a table is often referenced with a string in the format of: <project_id>:<dataset_id>.<table_id> or <project_id>.<dataset_id>.<table_id>

jobs[].riskDetails.requestedSourceTable.datasetId STRING

Dataset ID of the table

jobs[].riskDetails.requestedSourceTable.tableId STRING

Name of the table

jobs[].riskDetails.requestedSourceTable.projectId STRING

The Google Cloud Platform project ID of the project containing the table. If omitted, project ID is inferred from the API call

jobs[].riskDetails.categoricalStatsResult OBJECT

Result of the categorical stats computation

jobs[].riskDetails.requestedPrivacyMetric OBJECT

Privacy metric to compute for reidentification risk analysis

jobs[].riskDetails.numericalStatsResult OBJECT

Result of the numerical stats computation

jobs[].riskDetails.kAnonymityResult OBJECT

Result of the k-anonymity computation

jobs[].name STRING

The server-assigned name

jobs[].type ENUMERATION

The type of job

jobs[].endTime ANY

Time when the job finished

jobs[].errors[] OBJECT

Details information about an error encountered during job execution or the results of an unsuccessful activation of the JobTrigger. Output only field

jobs[].errors[].timestamps[] ANY

jobs[].errors[].details OBJECT

The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details.

You can find out more about this error model and how to work with it in the API Design Guide

jobs[].startTime ANY

Time when the job started

jobs[].inspectDetails OBJECT

The results of an inspect DataSource job

jobs[].inspectDetails.result OBJECT

All result fields mentioned below are updated while the job is processing

jobs[].inspectDetails.result.totalEstimatedBytes INTEGER

Estimate of the number of bytes to process

jobs[].inspectDetails.result.processedBytes INTEGER

Total size in bytes that were processed

jobs[].inspectDetails.requestedOptions OBJECT