DlpServiceClient

DlpServiceClient

The Cloud Data Loss Prevention (DLP) API is a service that allows clients to detect the presence of Personally Identifiable Information (PII) and other privacy-sensitive data in user-supplied, unstructured data streams, like text blocks or images. The service also includes methods for sensitive data redaction and scheduling of data scans on Google Cloud Platform based data sets.

To learn more about concepts and find how-to guides see https://cloud.google.com/sensitive-data-protection/docs/.

Constructor

new DlpServiceClient(optionsopt, gaxInstanceopt)

Construct an instance of DlpServiceClient.

Parameters:
Name Type Attributes Description
options object <optional>

The configuration object. The options accepted by the constructor are described in detail in this document. The common options are:

Properties
Name Type Attributes Description
credentials object <optional>

Credentials object.

Properties
Name Type Attributes Description
client_email string <optional>
private_key string <optional>
email string <optional>

Account email address. Required when using a .pem or .p12 keyFilename.

keyFilename string <optional>

Full path to the a .json, .pem, or .p12 key downloaded from the Google Developers Console. If you provide a path to a JSON file, the projectId option below is not necessary. NOTE: .pem and .p12 require you to specify options.email as well.

port number <optional>

The port on which to connect to the remote host.

projectId string <optional>

The project ID from the Google Developer's Console, e.g. 'grape-spaceship-123'. We will also check the environment variable GCLOUD_PROJECT for your project ID. If your app is running in an environment which supports Application Default Credentials, your project ID will be detected automatically.

apiEndpoint string <optional>

The domain name of the API remote host.

clientConfig gax.ClientConfig <optional>

Client configuration override. Follows the structure of gapicConfig.

fallback boolean <optional>

Use HTTP/1.1 REST mode. For more information, please check the documentation.

gaxInstance gax <optional>

loaded instance of google-gax. Useful if you need to avoid loading the default gRPC version and want to use the fallback HTTP implementation. Load only fallback version and pass it to the constructor: const gax = require('google-gax/build/src/fallback'); // avoids loading google-gax with gRPC const client = new DlpServiceClient({fallback: true}, gax);

Members

apiEndpoint

The DNS address for this API service.

apiEndpoint

The DNS address for this API service - same as servicePath.

port

The port for this API service.

scopes

The scopes needed to make gRPC calls for every method defined in this service.

servicePath

The DNS address for this API service.

Methods

close() → {Promise}

Terminate the gRPC channel and close the client.

The client will no longer be usable and all future behavior is undefined.

Returns:
Type Description
Promise

A promise that resolves when the client is closed.

discoveryConfigPath(project, location, discovery_config) → {string}

Return a fully-qualified discoveryConfig resource name string.

Parameters:
Name Type Description
project string
location string
discovery_config string
Returns:
Type Description
string

Resource name string.

findingPath(project, location, finding) → {string}

Return a fully-qualified finding resource name string.

Parameters:
Name Type Description
project string
location string
finding string
Returns:
Type Description
string

Resource name string.

getLocation(request, optionsopt) → {Promise}

Gets information about a location.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
name string

Resource name for the location.

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Promise
  • The promise which resolves to an array. The first element of the array is an object representing Location. Please see the documentation for more details and examples.
Example
```
const [response] = await client.getLocation(request);
```

getProjectId() → {Promise}

Return the project ID used by this class.

Returns:
Type Description
Promise

A promise that resolves to string containing the project ID.

initialize() → {Promise}

Initialize the client. Performs asynchronous operations (such as authentication) and prepares the client. This function will be called automatically when any class method is called for the first time, but if you need to initialize it before calling an actual method, feel free to call initialize() directly.

You can await on this method if you want to make sure the client is initialized.

Returns:
Type Description
Promise

A promise that resolves to an authenticated service stub.

listColumnDataProfilesAsync(request, optionsopt) → {Object}

Equivalent to listColumnDataProfiles, but returns an iterable object.

for-await-of syntax is used with the iterable to get response elements on-demand.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Resource name of the organization or project, for example organizations/433245324/locations/europe or projects/project-id/locations/asia.

pageToken string

Page token to continue retrieval.

pageSize number

Size of the page. This value can be limited by the server. If zero, server returns a page of max size 100.

orderBy string

Comma-separated list of fields to order by, followed by asc or desc postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed.

Examples:

  • project_id asc
  • table_id
  • sensitivity_level desc

Supported fields are:

  • project_id: The Google Cloud project ID.
  • dataset_id: The ID of a BigQuery dataset.
  • table_id: The ID of a BigQuery table.
  • sensitivity_level: How sensitive the data in a column is, at most.
  • data_risk_level: How much risk is associated with this data.
  • profile_last_generated: When the profile was last updated in epoch seconds.
filter string

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:
    • table_data_profile_name - The name of the related table data profile.
    • project_id - The Google Cloud project ID. (REQUIRED)
    • dataset_id - The BigQuery dataset ID. (REQUIRED)
    • table_id - The BigQuery table ID. (REQUIRED)
    • field_id - The ID of the BigQuery field.
    • info_type - The infotype detected in the resource.
    • sensitivity_level - HIGH|MEDIUM|LOW
    • data_risk_level: How much risk is associated with this data.
    • status_code - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
  • The operator must be = for project_id, dataset_id, and table_id. Other filters also support !=.

Examples:

  • project_id = 12345 AND status_code = 1
  • project_id = 12345 AND sensitivity_level = HIGH
  • project_id = 12345 AND info_type = STREET_ADDRESS

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

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Object

An iterable Object that allows async iteration. When you iterate the returned iterable, each element will be an object representing ColumnDataProfile. The API will be called under the hood as needed, once per the page, so you can stop the iteration when you don't need more results. Please see the documentation for more details and examples.

Example
  /**
   * This snippet has been automatically generated and should be regarded as a code template only.
   * It will require modifications to work.
   * It may require correct/in-range values for request initialization.
   * TODO(developer): Uncomment these variables before running the sample.
   */
  /**
   *  Required. Resource name of the organization or project, for
   *  example `organizations/433245324/locations/europe` or
   *  `projects/project-id/locations/asia`.
   */
  // const parent = 'abc123'
  /**
   *  Page token to continue retrieval.
   */
  // const pageToken = 'abc123'
  /**
   *  Size of the page. This value can be limited by the server. If zero, server
   *  returns a page of max size 100.
   */
  // const pageSize = 1234
  /**
   *  Comma-separated list of fields to order by, followed by `asc` or `desc`
   *  postfix. This list is case insensitive. The default sorting order is
   *  ascending. Redundant space characters are insignificant. Only one order
   *  field at a time is allowed.
   *  Examples:
   *  * `project_id asc`
   *  * `table_id`
   *  * `sensitivity_level desc`
   *  Supported fields are:
   *  - `project_id`: The Google Cloud project ID.
   *  - `dataset_id`: The ID of a BigQuery dataset.
   *  - `table_id`: The ID of a BigQuery table.
   *  - `sensitivity_level`: How sensitive the data in a column is, at most.
   *  - `data_risk_level`: How much risk is associated with this data.
   *  - `profile_last_generated`: When the profile was last updated in epoch
   *  seconds.
   */
  // const orderBy = 'abc123'
  /**
   *  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:
   *      - `table_data_profile_name` - The name of the related table data
   *      profile.
   *      - `project_id` - The Google Cloud project ID. (REQUIRED)
   *      - `dataset_id` - The BigQuery dataset ID. (REQUIRED)
   *      - `table_id` - The BigQuery table ID. (REQUIRED)
   *      - `field_id` - The ID of the BigQuery field.
   *      - `info_type` - The infotype detected in the resource.
   *      - `sensitivity_level` - HIGH|MEDIUM|LOW
   *      - `data_risk_level`: How much risk is associated with this data.
   *      - `status_code` - an RPC status code as defined in
   *      https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
   *  * The operator must be `=` for project_id, dataset_id, and table_id. Other
   *    filters also support `!=`.
   *  Examples:
   *  * project_id = 12345 AND status_code = 1
   *  * project_id = 12345 AND sensitivity_level = HIGH
   *  * project_id = 12345 AND info_type = STREET_ADDRESS
   *  The length of this field should be no more than 500 characters.
   */
  // const filter = 'abc123'

  // Imports the Dlp library
  const {DlpServiceClient} = require('@google-cloud/dlp').v2;

  // Instantiates a client
  const dlpClient = new DlpServiceClient();

  async function callListColumnDataProfiles() {
    // Construct request
    const request = {
      parent,
    };

    // Run request
    const iterable = dlpClient.listColumnDataProfilesAsync(request);
    for await (const response of iterable) {
        console.log(response);
    }
  }

  callListColumnDataProfiles();

listColumnDataProfilesStream(request, optionsopt) → {Stream}

Equivalent to method.name.toCamelCase(), but returns a NodeJS Stream object.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Resource name of the organization or project, for example organizations/433245324/locations/europe or projects/project-id/locations/asia.

pageToken string

Page token to continue retrieval.

pageSize number

Size of the page. This value can be limited by the server. If zero, server returns a page of max size 100.

orderBy string

Comma-separated list of fields to order by, followed by asc or desc postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed.

Examples:

  • project_id asc
  • table_id
  • sensitivity_level desc

Supported fields are:

  • project_id: The Google Cloud project ID.
  • dataset_id: The ID of a BigQuery dataset.
  • table_id: The ID of a BigQuery table.
  • sensitivity_level: How sensitive the data in a column is, at most.
  • data_risk_level: How much risk is associated with this data.
  • profile_last_generated: When the profile was last updated in epoch seconds.
filter string

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:
    • table_data_profile_name - The name of the related table data profile.
    • project_id - The Google Cloud project ID. (REQUIRED)
    • dataset_id - The BigQuery dataset ID. (REQUIRED)
    • table_id - The BigQuery table ID. (REQUIRED)
    • field_id - The ID of the BigQuery field.
    • info_type - The infotype detected in the resource.
    • sensitivity_level - HIGH|MEDIUM|LOW
    • data_risk_level: How much risk is associated with this data.
    • status_code - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
  • The operator must be = for project_id, dataset_id, and table_id. Other filters also support !=.

Examples:

  • project_id = 12345 AND status_code = 1
  • project_id = 12345 AND sensitivity_level = HIGH
  • project_id = 12345 AND info_type = STREET_ADDRESS

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

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Stream

An object stream which emits an object representing ColumnDataProfile on 'data' event. The client library will perform auto-pagination by default: it will call the API as many times as needed. Note that it can affect your quota. We recommend using listColumnDataProfilesAsync() method described below for async iteration which you can stop as needed. Please see the documentation for more details and examples.

listConnectionsAsync(request, optionsopt) → {Object}

Equivalent to listConnections, but returns an iterable object.

for-await-of syntax is used with the iterable to get response elements on-demand.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Attributes Description
parent string

Required. Resource name of the organization or project, for example, organizations/433245324/locations/europe or projects/project-id/locations/asia.

pageSize number <optional>

Optional. Number of results per page, max 1000.

pageToken string <optional>

Optional. Page token from a previous page to return the next set of results. If set, all other request fields must match the original request.

filter string <optional>

Optional. Supported field/value: state - MISSING|AVAILABLE|ERROR

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Object

An iterable Object that allows async iteration. When you iterate the returned iterable, each element will be an object representing Connection. The API will be called under the hood as needed, once per the page, so you can stop the iteration when you don't need more results. Please see the documentation for more details and examples.

Example
  /**
   * This snippet has been automatically generated and should be regarded as a code template only.
   * It will require modifications to work.
   * It may require correct/in-range values for request initialization.
   * TODO(developer): Uncomment these variables before running the sample.
   */
  /**
   *  Required. Resource name of the organization or project, for
   *  example, `organizations/433245324/locations/europe` or
   *  `projects/project-id/locations/asia`.
   */
  // const parent = 'abc123'
  /**
   *  Optional. Number of results per page, max 1000.
   */
  // const pageSize = 1234
  /**
   *  Optional. Page token from a previous page to return the next set of
   *  results. If set, all other request fields must match the original request.
   */
  // const pageToken = 'abc123'
  /**
   *  Optional. Supported field/value: `state` - MISSING|AVAILABLE|ERROR
   */
  // const filter = 'abc123'

  // Imports the Dlp library
  const {DlpServiceClient} = require('@google-cloud/dlp').v2;

  // Instantiates a client
  const dlpClient = new DlpServiceClient();

  async function callListConnections() {
    // Construct request
    const request = {
      parent,
    };

    // Run request
    const iterable = dlpClient.listConnectionsAsync(request);
    for await (const response of iterable) {
        console.log(response);
    }
  }

  callListConnections();

listConnectionsStream(request, optionsopt) → {Stream}

Equivalent to method.name.toCamelCase(), but returns a NodeJS Stream object.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Attributes Description
parent string

Required. Resource name of the organization or project, for example, organizations/433245324/locations/europe or projects/project-id/locations/asia.

pageSize number <optional>

Optional. Number of results per page, max 1000.

pageToken string <optional>

Optional. Page token from a previous page to return the next set of results. If set, all other request fields must match the original request.

filter string <optional>

Optional. Supported field/value: state - MISSING|AVAILABLE|ERROR

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Stream

An object stream which emits an object representing Connection on 'data' event. The client library will perform auto-pagination by default: it will call the API as many times as needed. Note that it can affect your quota. We recommend using listConnectionsAsync() method described below for async iteration which you can stop as needed. Please see the documentation for more details and examples.

listDeidentifyTemplatesAsync(request, optionsopt) → {Object}

Equivalent to listDeidentifyTemplates, but returns an iterable object.

for-await-of syntax is used with the iterable to get response elements on-demand.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Parent resource name.

The format of this value varies depending on the scope of the request (project or organization) and whether you have specified a processing location:

  • Projects scope, location specified: projects/{project_id}/locations/{location_id}
  • Projects scope, no location specified (defaults to global): projects/{project_id}
  • Organizations scope, location specified: organizations/{org_id}/locations/{location_id}
  • Organizations scope, no location specified (defaults to global): organizations/{org_id}

The following example parent string specifies a parent project with the identifier example-project, and specifies the europe-west3 location for processing data:

  parent=projects/example-project/locations/europe-west3
pageToken string

Page token to continue retrieval. Comes from the previous call to ListDeidentifyTemplates.

pageSize number

Size of the page. This value can be limited by the server. If zero server returns a page of max size 100.

orderBy string

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

Example: name asc,update_time, create_time desc

Supported fields are:

  • create_time: corresponds to the time the template was created.
  • update_time: corresponds to the time the template was last updated.
  • name: corresponds to the template's name.
  • display_name: corresponds to the template's display name.
locationId string

Deprecated. This field has no effect.

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Object

An iterable Object that allows async iteration. When you iterate the returned iterable, each element will be an object representing DeidentifyTemplate. The API will be called under the hood as needed, once per the page, so you can stop the iteration when you don't need more results. Please see the documentation for more details and examples.

Example
  /**
   * This snippet has been automatically generated and should be regarded as a code template only.
   * It will require modifications to work.
   * It may require correct/in-range values for request initialization.
   * TODO(developer): Uncomment these variables before running the sample.
   */
  /**
   *  Required. Parent resource name.
   *  The format of this value varies depending on the scope of the request
   *  (project or organization) and whether you have specified a processing
   *  location (https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
   *  + Projects scope, location specified:
   *    `projects/{project_id}/locations/{location_id}`
   *  + Projects scope, no location specified (defaults to global):
   *    `projects/{project_id}`
   *  + Organizations scope, location specified:
   *    `organizations/{org_id}/locations/{location_id}`
   *  + Organizations scope, no location specified (defaults to global):
   *    `organizations/{org_id}`
   *  The following example `parent` string specifies a parent project with the
   *  identifier `example-project`, and specifies the `europe-west3` location
   *  for processing data:
   *      parent=projects/example-project/locations/europe-west3
   */
  // const parent = 'abc123'
  /**
   *  Page token to continue retrieval. Comes from the previous call
   *  to `ListDeidentifyTemplates`.
   */
  // const pageToken = 'abc123'
  /**
   *  Size of the page. This value can be limited by the server. If zero server
   *  returns a page of max size 100.
   */
  // const pageSize = 1234
  /**
   *  Comma-separated list of fields to order by,
   *  followed by `asc` or `desc` postfix. This list is case insensitive. The
   *  default sorting order is ascending. Redundant space characters are
   *  insignificant.
   *  Example: `name asc,update_time, create_time desc`
   *  Supported fields are:
   *  - `create_time`: corresponds to the time the template was created.
   *  - `update_time`: corresponds to the time the template was last updated.
   *  - `name`: corresponds to the template's name.
   *  - `display_name`: corresponds to the template's display name.
   */
  // const orderBy = 'abc123'

  // Imports the Dlp library
  const {DlpServiceClient} = require('@google-cloud/dlp').v2;

  // Instantiates a client
  const dlpClient = new DlpServiceClient();

  async function callListDeidentifyTemplates() {
    // Construct request
    const request = {
      parent,
    };

    // Run request
    const iterable = dlpClient.listDeidentifyTemplatesAsync(request);
    for await (const response of iterable) {
        console.log(response);
    }
  }

  callListDeidentifyTemplates();

listDeidentifyTemplatesStream(request, optionsopt) → {Stream}

Equivalent to method.name.toCamelCase(), but returns a NodeJS Stream object.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Parent resource name.

The format of this value varies depending on the scope of the request (project or organization) and whether you have specified a processing location:

  • Projects scope, location specified: projects/{project_id}/locations/{location_id}
  • Projects scope, no location specified (defaults to global): projects/{project_id}
  • Organizations scope, location specified: organizations/{org_id}/locations/{location_id}
  • Organizations scope, no location specified (defaults to global): organizations/{org_id}

The following example parent string specifies a parent project with the identifier example-project, and specifies the europe-west3 location for processing data:

  parent=projects/example-project/locations/europe-west3
pageToken string

Page token to continue retrieval. Comes from the previous call to ListDeidentifyTemplates.

pageSize number

Size of the page. This value can be limited by the server. If zero server returns a page of max size 100.

orderBy string

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

Example: name asc,update_time, create_time desc

Supported fields are:

  • create_time: corresponds to the time the template was created.
  • update_time: corresponds to the time the template was last updated.
  • name: corresponds to the template's name.
  • display_name: corresponds to the template's display name.
locationId string

Deprecated. This field has no effect.

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Stream

An object stream which emits an object representing DeidentifyTemplate on 'data' event. The client library will perform auto-pagination by default: it will call the API as many times as needed. Note that it can affect your quota. We recommend using listDeidentifyTemplatesAsync() method described below for async iteration which you can stop as needed. Please see the documentation for more details and examples.

listDiscoveryConfigsAsync(request, optionsopt) → {Object}

Equivalent to listDiscoveryConfigs, but returns an iterable object.

for-await-of syntax is used with the iterable to get response elements on-demand.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Parent resource name.

The format of this value is as follows: projects/{project_id}/locations/{location_id}

The following example parent string specifies a parent project with the identifier example-project, and specifies the europe-west3 location for processing data:

  parent=projects/example-project/locations/europe-west3
pageToken string

Page token to continue retrieval. Comes from the previous call to ListDiscoveryConfigs. order_by field must not change for subsequent calls.

pageSize number

Size of the page. This value can be limited by a server.

orderBy string

Comma-separated list of config fields to order by, followed by asc or desc postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant.

Example: name asc,update_time, create_time desc

Supported fields are:

  • last_run_time: corresponds to the last time the DiscoveryConfig ran.
  • name: corresponds to the DiscoveryConfig's name.
  • status: corresponds to DiscoveryConfig's status.
options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Object

An iterable Object that allows async iteration. When you iterate the returned iterable, each element will be an object representing DiscoveryConfig. The API will be called under the hood as needed, once per the page, so you can stop the iteration when you don't need more results. Please see the documentation for more details and examples.

Example
  /**
   * This snippet has been automatically generated and should be regarded as a code template only.
   * It will require modifications to work.
   * It may require correct/in-range values for request initialization.
   * TODO(developer): Uncomment these variables before running the sample.
   */
  /**
   *  Required. Parent resource name.
   *  The format of this value is as follows:
   *  `projects/{project_id}/locations/{location_id}`
   *  The following example `parent` string specifies a parent project with the
   *  identifier `example-project`, and specifies the `europe-west3` location
   *  for processing data:
   *      parent=projects/example-project/locations/europe-west3
   */
  // const parent = 'abc123'
  /**
   *  Page token to continue retrieval. Comes from the previous call
   *  to ListDiscoveryConfigs. `order_by` field must not
   *  change for subsequent calls.
   */
  // const pageToken = 'abc123'
  /**
   *  Size of the page. This value can be limited by a server.
   */
  // const pageSize = 1234
  /**
   *  Comma-separated list of config fields to order by,
   *  followed by `asc` or `desc` postfix. This list is case insensitive. The
   *  default sorting order is ascending. Redundant space characters are
   *  insignificant.
   *  Example: `name asc,update_time, create_time desc`
   *  Supported fields are:
   *  - `last_run_time`: corresponds to the last time the DiscoveryConfig ran.
   *  - `name`: corresponds to the DiscoveryConfig's name.
   *  - `status`: corresponds to DiscoveryConfig's status.
   */
  // const orderBy = 'abc123'

  // Imports the Dlp library
  const {DlpServiceClient} = require('@google-cloud/dlp').v2;

  // Instantiates a client
  const dlpClient = new DlpServiceClient();

  async function callListDiscoveryConfigs() {
    // Construct request
    const request = {
      parent,
    };

    // Run request
    const iterable = dlpClient.listDiscoveryConfigsAsync(request);
    for await (const response of iterable) {
        console.log(response);
    }
  }

  callListDiscoveryConfigs();

listDiscoveryConfigsStream(request, optionsopt) → {Stream}

Equivalent to method.name.toCamelCase(), but returns a NodeJS Stream object.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Parent resource name.

The format of this value is as follows: projects/{project_id}/locations/{location_id}

The following example parent string specifies a parent project with the identifier example-project, and specifies the europe-west3 location for processing data:

  parent=projects/example-project/locations/europe-west3
pageToken string

Page token to continue retrieval. Comes from the previous call to ListDiscoveryConfigs. order_by field must not change for subsequent calls.

pageSize number

Size of the page. This value can be limited by a server.

orderBy string

Comma-separated list of config fields to order by, followed by asc or desc postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant.

Example: name asc,update_time, create_time desc

Supported fields are:

  • last_run_time: corresponds to the last time the DiscoveryConfig ran.
  • name: corresponds to the DiscoveryConfig's name.
  • status: corresponds to DiscoveryConfig's status.
options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Stream

An object stream which emits an object representing DiscoveryConfig on 'data' event. The client library will perform auto-pagination by default: it will call the API as many times as needed. Note that it can affect your quota. We recommend using listDiscoveryConfigsAsync() method described below for async iteration which you can stop as needed. Please see the documentation for more details and examples.

listDlpJobsAsync(request, optionsopt) → {Object}

Equivalent to listDlpJobs, but returns an iterable object.

for-await-of syntax is used with the iterable to get response elements on-demand.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Parent resource name.

The format of this value varies depending on whether you have specified a processing location:

  • Projects scope, location specified: projects/{project_id}/locations/{location_id}
  • Projects scope, no location specified (defaults to global): projects/{project_id}

The following example parent string specifies a parent project with the identifier example-project, and specifies the europe-west3 location for processing data:

  parent=projects/example-project/locations/europe-west3
filter string

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 name of the trigger that created the job.
    • 'end_time` - Corresponds to the time the job finished.
    • 'start_time` - Corresponds to the time the job finished.
  • Supported fields for risk analysis jobs:
    • state - RUNNING|CANCELED|FINISHED|FAILED
    • 'end_time` - Corresponds to the time the job finished.
    • 'start_time` - Corresponds to the 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.

pageSize number

The standard list page size.

pageToken string

The standard list page token.

type google.privacy.dlp.v2.DlpJobType

The type of job. Defaults to DlpJobType.INSPECT

orderBy string

Comma-separated list of fields to order by, followed by asc or desc postfix. This list is case insensitive. The 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 the time the job was created.
  • end_time: corresponds to the time the job ended.
  • name: corresponds to the job's name.
  • state: corresponds to state
locationId string

Deprecated. This field has no effect.

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Object

An iterable Object that allows async iteration. When you iterate the returned iterable, each element will be an object representing DlpJob. The API will be called under the hood as needed, once per the page, so you can stop the iteration when you don't need more results. Please see the documentation for more details and examples.

Example
  /**
   * This snippet has been automatically generated and should be regarded as a code template only.
   * It will require modifications to work.
   * It may require correct/in-range values for request initialization.
   * TODO(developer): Uncomment these variables before running the sample.
   */
  /**
   *  Required. Parent resource name.
   *  The format of this value varies depending on whether you have specified a
   *  processing
   *  location (https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
   *  + Projects scope, location specified:
   *    `projects/{project_id}/locations/{location_id}`
   *  + Projects scope, no location specified (defaults to global):
   *    `projects/{project_id}`
   *  The following example `parent` string specifies a parent project with the
   *  identifier `example-project`, and specifies the `europe-west3` location
   *  for processing data:
   *      parent=projects/example-project/locations/europe-west3
   */
  // const parent = 'abc123'
  /**
   *  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 name of the trigger that created the job.
   *      - 'end_time` - Corresponds to the time the job finished.
   *      - 'start_time` - Corresponds to the time the job finished.
   *  * Supported fields for risk analysis jobs:
   *      - `state` - RUNNING|CANCELED|FINISHED|FAILED
   *      - 'end_time` - Corresponds to the time the job finished.
   *      - 'start_time` - Corresponds to the 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.
   */
  // const filter = 'abc123'
  /**
   *  The standard list page size.
   */
  // const pageSize = 1234
  /**
   *  The standard list page token.
   */
  // const pageToken = 'abc123'
  /**
   *  The type of job. Defaults to `DlpJobType.INSPECT`
   */
  // const type = {}
  /**
   *  Comma-separated list of fields to order by,
   *  followed by `asc` or `desc` postfix. This list is case insensitive. The
   *  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 the time the job was created.
   *  - `end_time`: corresponds to the time the job ended.
   *  - `name`: corresponds to the job's name.
   *  - `state`: corresponds to `state`
   */
  // const orderBy = 'abc123'

  // Imports the Dlp library
  const {DlpServiceClient} = require('@google-cloud/dlp').v2;

  // Instantiates a client
  const dlpClient = new DlpServiceClient();

  async function callListDlpJobs() {
    // Construct request
    const request = {
      parent,
    };

    // Run request
    const iterable = dlpClient.listDlpJobsAsync(request);
    for await (const response of iterable) {
        console.log(response);
    }
  }

  callListDlpJobs();

listDlpJobsStream(request, optionsopt) → {Stream}

Equivalent to method.name.toCamelCase(), but returns a NodeJS Stream object.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Parent resource name.

The format of this value varies depending on whether you have specified a processing location:

  • Projects scope, location specified: projects/{project_id}/locations/{location_id}
  • Projects scope, no location specified (defaults to global): projects/{project_id}

The following example parent string specifies a parent project with the identifier example-project, and specifies the europe-west3 location for processing data:

  parent=projects/example-project/locations/europe-west3
filter string

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 name of the trigger that created the job.
    • 'end_time` - Corresponds to the time the job finished.
    • 'start_time` - Corresponds to the time the job finished.
  • Supported fields for risk analysis jobs:
    • state - RUNNING|CANCELED|FINISHED|FAILED
    • 'end_time` - Corresponds to the time the job finished.
    • 'start_time` - Corresponds to the 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.

pageSize number

The standard list page size.

pageToken string

The standard list page token.

type google.privacy.dlp.v2.DlpJobType

The type of job. Defaults to DlpJobType.INSPECT

orderBy string

Comma-separated list of fields to order by, followed by asc or desc postfix. This list is case insensitive. The 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 the time the job was created.
  • end_time: corresponds to the time the job ended.
  • name: corresponds to the job's name.
  • state: corresponds to state
locationId string

Deprecated. This field has no effect.

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Stream

An object stream which emits an object representing DlpJob on 'data' event. The client library will perform auto-pagination by default: it will call the API as many times as needed. Note that it can affect your quota. We recommend using listDlpJobsAsync() method described below for async iteration which you can stop as needed. Please see the documentation for more details and examples.

listFileStoreDataProfilesAsync(request, optionsopt) → {Object}

Equivalent to listFileStoreDataProfiles, but returns an iterable object.

for-await-of syntax is used with the iterable to get response elements on-demand.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Attributes Description
parent string

Required. Resource name of the organization or project, for example organizations/433245324/locations/europe or projects/project-id/locations/asia.

pageToken string <optional>

Optional. Page token to continue retrieval.

pageSize number <optional>

Optional. Size of the page. This value can be limited by the server. If zero, server returns a page of max size 100.

orderBy string <optional>

Optional. Comma-separated list of fields to order by, followed by asc or desc postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed.

Examples:

  • project_id asc
  • name
  • sensitivity_level desc

Supported fields are:

  • project_id: The Google Cloud project ID.
  • sensitivity_level: How sensitive the data in a table is, at most.
  • data_risk_level: How much risk is associated with this data.
  • profile_last_generated: When the profile was last updated in epoch seconds.
  • last_modified: The last time the resource was modified.
  • resource_visibility: Visibility restriction for this resource.
  • name: The name of the profile.
  • create_time: The time the file store was first created.
filter string <optional>

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:
    • project_id - The Google Cloud project ID.
    • account_id - The AWS account ID.
    • file_store_path - The path like "gs://bucket".
    • data_source_type - The profile's data source type, like "google/storage/bucket".
    • data_storage_location - The location where the file store's data is stored, like "us-central1".
    • sensitivity_level - HIGH|MODERATE|LOW
    • data_risk_level - HIGH|MODERATE|LOW
    • resource_visibility: PUBLIC|RESTRICTED
    • status_code - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
  • The operator must be = or !=.

Examples:

  • project_id = 12345 AND status_code = 1
  • project_id = 12345 AND sensitivity_level = HIGH
  • project_id = 12345 AND resource_visibility = PUBLIC
  • file_store_path = "gs://mybucket"

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

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Object

An iterable Object that allows async iteration. When you iterate the returned iterable, each element will be an object representing FileStoreDataProfile. The API will be called under the hood as needed, once per the page, so you can stop the iteration when you don't need more results. Please see the documentation for more details and examples.

Example
  /**
   * This snippet has been automatically generated and should be regarded as a code template only.
   * It will require modifications to work.
   * It may require correct/in-range values for request initialization.
   * TODO(developer): Uncomment these variables before running the sample.
   */
  /**
   *  Required. Resource name of the organization or project, for
   *  example `organizations/433245324/locations/europe` or
   *  `projects/project-id/locations/asia`.
   */
  // const parent = 'abc123'
  /**
   *  Optional. Page token to continue retrieval.
   */
  // const pageToken = 'abc123'
  /**
   *  Optional. Size of the page. This value can be limited by the server. If
   *  zero, server returns a page of max size 100.
   */
  // const pageSize = 1234
  /**
   *  Optional. Comma-separated list of fields to order by, followed by `asc` or
   *  `desc` postfix. This list is case insensitive. The default sorting order is
   *  ascending. Redundant space characters are insignificant. Only one order
   *  field at a time is allowed.
   *  Examples:
   *  * `project_id asc`
   *  * `name`
   *  * `sensitivity_level desc`
   *  Supported fields are:
   *  - `project_id`: The Google Cloud project ID.
   *  - `sensitivity_level`: How sensitive the data in a table is, at most.
   *  - `data_risk_level`: How much risk is associated with this data.
   *  - `profile_last_generated`: When the profile was last updated in epoch
   *  seconds.
   *  - `last_modified`: The last time the resource was modified.
   *  - `resource_visibility`: Visibility restriction for this resource.
   *  - `name`: The name of the profile.
   *  - `create_time`: The time the file store was first created.
   */
  // const orderBy = 'abc123'
  /**
   *  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:
   *      - `project_id` - The Google Cloud project ID.
   *      - `account_id` - The AWS account ID.
   *      - `file_store_path` - The path like "gs://bucket".
   *      - `data_source_type` - The profile's data source type, like
   *      "google/storage/bucket".
   *      - `data_storage_location` - The location where the file store's data is
   *      stored, like "us-central1".
   *      - `sensitivity_level` - HIGH|MODERATE|LOW
   *      - `data_risk_level` - HIGH|MODERATE|LOW
   *      - `resource_visibility`: PUBLIC|RESTRICTED
   *      - `status_code` - an RPC status code as defined in
   *      https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
   *  * The operator must be `=` or `!=`.
   *  Examples:
   *  * `project_id = 12345 AND status_code = 1`
   *  * `project_id = 12345 AND sensitivity_level = HIGH`
   *  * `project_id = 12345 AND resource_visibility = PUBLIC`
   *  * `file_store_path = "gs://mybucket"`
   *  The length of this field should be no more than 500 characters.
   */
  // const filter = 'abc123'

  // Imports the Dlp library
  const {DlpServiceClient} = require('@google-cloud/dlp').v2;

  // Instantiates a client
  const dlpClient = new DlpServiceClient();

  async function callListFileStoreDataProfiles() {
    // Construct request
    const request = {
      parent,
    };

    // Run request
    const iterable = dlpClient.listFileStoreDataProfilesAsync(request);
    for await (const response of iterable) {
        console.log(response);
    }
  }

  callListFileStoreDataProfiles();

listFileStoreDataProfilesStream(request, optionsopt) → {Stream}

Equivalent to method.name.toCamelCase(), but returns a NodeJS Stream object.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Attributes Description
parent string

Required. Resource name of the organization or project, for example organizations/433245324/locations/europe or projects/project-id/locations/asia.

pageToken string <optional>

Optional. Page token to continue retrieval.

pageSize number <optional>

Optional. Size of the page. This value can be limited by the server. If zero, server returns a page of max size 100.

orderBy string <optional>

Optional. Comma-separated list of fields to order by, followed by asc or desc postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed.

Examples:

  • project_id asc
  • name
  • sensitivity_level desc

Supported fields are:

  • project_id: The Google Cloud project ID.
  • sensitivity_level: How sensitive the data in a table is, at most.
  • data_risk_level: How much risk is associated with this data.
  • profile_last_generated: When the profile was last updated in epoch seconds.
  • last_modified: The last time the resource was modified.
  • resource_visibility: Visibility restriction for this resource.
  • name: The name of the profile.
  • create_time: The time the file store was first created.
filter string <optional>

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:
    • project_id - The Google Cloud project ID.
    • account_id - The AWS account ID.
    • file_store_path - The path like "gs://bucket".
    • data_source_type - The profile's data source type, like "google/storage/bucket".
    • data_storage_location - The location where the file store's data is stored, like "us-central1".
    • sensitivity_level - HIGH|MODERATE|LOW
    • data_risk_level - HIGH|MODERATE|LOW
    • resource_visibility: PUBLIC|RESTRICTED
    • status_code - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
  • The operator must be = or !=.

Examples:

  • project_id = 12345 AND status_code = 1
  • project_id = 12345 AND sensitivity_level = HIGH
  • project_id = 12345 AND resource_visibility = PUBLIC
  • file_store_path = "gs://mybucket"

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

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Stream

An object stream which emits an object representing FileStoreDataProfile on 'data' event. The client library will perform auto-pagination by default: it will call the API as many times as needed. Note that it can affect your quota. We recommend using listFileStoreDataProfilesAsync() method described below for async iteration which you can stop as needed. Please see the documentation for more details and examples.

listInspectTemplatesAsync(request, optionsopt) → {Object}

Equivalent to listInspectTemplates, but returns an iterable object.

for-await-of syntax is used with the iterable to get response elements on-demand.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Parent resource name.

The format of this value varies depending on the scope of the request (project or organization) and whether you have specified a processing location:

  • Projects scope, location specified: projects/{project_id}/locations/{location_id}
  • Projects scope, no location specified (defaults to global): projects/{project_id}
  • Organizations scope, location specified: organizations/{org_id}/locations/{location_id}
  • Organizations scope, no location specified (defaults to global): organizations/{org_id}

The following example parent string specifies a parent project with the identifier example-project, and specifies the europe-west3 location for processing data:

  parent=projects/example-project/locations/europe-west3
pageToken string

Page token to continue retrieval. Comes from the previous call to ListInspectTemplates.

pageSize number

Size of the page. This value can be limited by the server. If zero server returns a page of max size 100.

orderBy string

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

Example: name asc,update_time, create_time desc

Supported fields are:

  • create_time: corresponds to the time the template was created.
  • update_time: corresponds to the time the template was last updated.
  • name: corresponds to the template's name.
  • display_name: corresponds to the template's display name.
locationId string

Deprecated. This field has no effect.

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Object

An iterable Object that allows async iteration. When you iterate the returned iterable, each element will be an object representing InspectTemplate. The API will be called under the hood as needed, once per the page, so you can stop the iteration when you don't need more results. Please see the documentation for more details and examples.

Example
  /**
   * This snippet has been automatically generated and should be regarded as a code template only.
   * It will require modifications to work.
   * It may require correct/in-range values for request initialization.
   * TODO(developer): Uncomment these variables before running the sample.
   */
  /**
   *  Required. Parent resource name.
   *  The format of this value varies depending on the scope of the request
   *  (project or organization) and whether you have specified a processing
   *  location (https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
   *  + Projects scope, location specified:
   *    `projects/{project_id}/locations/{location_id}`
   *  + Projects scope, no location specified (defaults to global):
   *    `projects/{project_id}`
   *  + Organizations scope, location specified:
   *    `organizations/{org_id}/locations/{location_id}`
   *  + Organizations scope, no location specified (defaults to global):
   *    `organizations/{org_id}`
   *  The following example `parent` string specifies a parent project with the
   *  identifier `example-project`, and specifies the `europe-west3` location
   *  for processing data:
   *      parent=projects/example-project/locations/europe-west3
   */
  // const parent = 'abc123'
  /**
   *  Page token to continue retrieval. Comes from the previous call
   *  to `ListInspectTemplates`.
   */
  // const pageToken = 'abc123'
  /**
   *  Size of the page. This value can be limited by the server. If zero server
   *  returns a page of max size 100.
   */
  // const pageSize = 1234
  /**
   *  Comma-separated list of fields to order by,
   *  followed by `asc` or `desc` postfix. This list is case insensitive. The
   *  default sorting order is ascending. Redundant space characters are
   *  insignificant.
   *  Example: `name asc,update_time, create_time desc`
   *  Supported fields are:
   *  - `create_time`: corresponds to the time the template was created.
   *  - `update_time`: corresponds to the time the template was last updated.
   *  - `name`: corresponds to the template's name.
   *  - `display_name`: corresponds to the template's display name.
   */
  // const orderBy = 'abc123'

  // Imports the Dlp library
  const {DlpServiceClient} = require('@google-cloud/dlp').v2;

  // Instantiates a client
  const dlpClient = new DlpServiceClient();

  async function callListInspectTemplates() {
    // Construct request
    const request = {
      parent,
    };

    // Run request
    const iterable = dlpClient.listInspectTemplatesAsync(request);
    for await (const response of iterable) {
        console.log(response);
    }
  }

  callListInspectTemplates();

listInspectTemplatesStream(request, optionsopt) → {Stream}

Equivalent to method.name.toCamelCase(), but returns a NodeJS Stream object.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Parent resource name.

The format of this value varies depending on the scope of the request (project or organization) and whether you have specified a processing location:

  • Projects scope, location specified: projects/{project_id}/locations/{location_id}
  • Projects scope, no location specified (defaults to global): projects/{project_id}
  • Organizations scope, location specified: organizations/{org_id}/locations/{location_id}
  • Organizations scope, no location specified (defaults to global): organizations/{org_id}

The following example parent string specifies a parent project with the identifier example-project, and specifies the europe-west3 location for processing data:

  parent=projects/example-project/locations/europe-west3
pageToken string

Page token to continue retrieval. Comes from the previous call to ListInspectTemplates.

pageSize number

Size of the page. This value can be limited by the server. If zero server returns a page of max size 100.

orderBy string

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

Example: name asc,update_time, create_time desc

Supported fields are:

  • create_time: corresponds to the time the template was created.
  • update_time: corresponds to the time the template was last updated.
  • name: corresponds to the template's name.
  • display_name: corresponds to the template's display name.
locationId string

Deprecated. This field has no effect.

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Stream

An object stream which emits an object representing InspectTemplate on 'data' event. The client library will perform auto-pagination by default: it will call the API as many times as needed. Note that it can affect your quota. We recommend using listInspectTemplatesAsync() method described below for async iteration which you can stop as needed. Please see the documentation for more details and examples.

listJobTriggersAsync(request, optionsopt) → {Object}

Equivalent to listJobTriggers, but returns an iterable object.

for-await-of syntax is used with the iterable to get response elements on-demand.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Parent resource name.

The format of this value varies depending on whether you have specified a processing location:

  • Projects scope, location specified: projects/{project_id}/locations/{location_id}
  • Projects scope, no location specified (defaults to global): projects/{project_id}

The following example parent string specifies a parent project with the identifier example-project, and specifies the europe-west3 location for processing data:

  parent=projects/example-project/locations/europe-west3
pageToken string

Page token to continue retrieval. Comes from the previous call to ListJobTriggers. order_by field must not change for subsequent calls.

pageSize number

Size of the page. This value can be limited by a server.

orderBy string

Comma-separated list of triggeredJob fields to order by, followed by asc or desc postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant.

Example: name asc,update_time, create_time desc

Supported fields are:

  • create_time: corresponds to the time the JobTrigger was created.
  • update_time: corresponds to the time the JobTrigger was last updated.
  • last_run_time: corresponds to the last time the JobTrigger ran.
  • name: corresponds to the JobTrigger's name.
  • display_name: corresponds to the JobTrigger's display name.
  • status: corresponds to JobTrigger's status.
filter string

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 triggers:
    • status - HEALTHY|PAUSED|CANCELLED
    • inspected_storage - DATASTORE|CLOUD_STORAGE|BIGQUERY
    • 'last_run_time` - RFC 3339 formatted timestamp, surrounded by quotation marks. Nanoseconds are ignored.
    • 'error_count' - Number of errors that have occurred while running.
  • The operator must be = or != for status and inspected_storage.

Examples:

  • inspected_storage = cloud_storage AND status = HEALTHY
  • inspected_storage = cloud_storage OR inspected_storage = bigquery
  • inspected_storage = cloud_storage AND (state = PAUSED OR state = HEALTHY)
  • last_run_time > "2017-12-12T00:00:00+00:00"

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

type google.privacy.dlp.v2.DlpJobType

The type of jobs. Will use DlpJobType.INSPECT if not set.

locationId string

Deprecated. This field has no effect.

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Object

An iterable Object that allows async iteration. When you iterate the returned iterable, each element will be an object representing JobTrigger. The API will be called under the hood as needed, once per the page, so you can stop the iteration when you don't need more results. Please see the documentation for more details and examples.

Example
  /**
   * This snippet has been automatically generated and should be regarded as a code template only.
   * It will require modifications to work.
   * It may require correct/in-range values for request initialization.
   * TODO(developer): Uncomment these variables before running the sample.
   */
  /**
   *  Required. Parent resource name.
   *  The format of this value varies depending on whether you have specified a
   *  processing
   *  location (https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
   *  + Projects scope, location specified:
   *    `projects/{project_id}/locations/{location_id}`
   *  + Projects scope, no location specified (defaults to global):
   *    `projects/{project_id}`
   *  The following example `parent` string specifies a parent project with the
   *  identifier `example-project`, and specifies the `europe-west3` location
   *  for processing data:
   *      parent=projects/example-project/locations/europe-west3
   */
  // const parent = 'abc123'
  /**
   *  Page token to continue retrieval. Comes from the previous call
   *  to ListJobTriggers. `order_by` field must not
   *  change for subsequent calls.
   */
  // const pageToken = 'abc123'
  /**
   *  Size of the page. This value can be limited by a server.
   */
  // const pageSize = 1234
  /**
   *  Comma-separated list of triggeredJob fields to order by,
   *  followed by `asc` or `desc` postfix. This list is case insensitive. The
   *  default sorting order is ascending. Redundant space characters are
   *  insignificant.
   *  Example: `name asc,update_time, create_time desc`
   *  Supported fields are:
   *  - `create_time`: corresponds to the time the JobTrigger was created.
   *  - `update_time`: corresponds to the time the JobTrigger was last updated.
   *  - `last_run_time`: corresponds to the last time the JobTrigger ran.
   *  - `name`: corresponds to the JobTrigger's name.
   *  - `display_name`: corresponds to the JobTrigger's display name.
   *  - `status`: corresponds to JobTrigger's status.
   */
  // const orderBy = 'abc123'
  /**
   *  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 triggers:
   *      - `status` - HEALTHY|PAUSED|CANCELLED
   *      - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
   *      - 'last_run_time` - RFC 3339 formatted timestamp, surrounded by
   *      quotation marks. Nanoseconds are ignored.
   *      - 'error_count' - Number of errors that have occurred while running.
   *  * The operator must be `=` or `!=` for status and inspected_storage.
   *  Examples:
   *  * inspected_storage = cloud_storage AND status = HEALTHY
   *  * inspected_storage = cloud_storage OR inspected_storage = bigquery
   *  * inspected_storage = cloud_storage AND (state = PAUSED OR state = HEALTHY)
   *  * last_run_time > \"2017-12-12T00:00:00+00:00\"
   *  The length of this field should be no more than 500 characters.
   */
  // const filter = 'abc123'
  /**
   *  The type of jobs. Will use `DlpJobType.INSPECT` if not set.
   */
  // const type = {}

  // Imports the Dlp library
  const {DlpServiceClient} = require('@google-cloud/dlp').v2;

  // Instantiates a client
  const dlpClient = new DlpServiceClient();

  async function callListJobTriggers() {
    // Construct request
    const request = {
      parent,
    };

    // Run request
    const iterable = dlpClient.listJobTriggersAsync(request);
    for await (const response of iterable) {
        console.log(response);
    }
  }

  callListJobTriggers();

listJobTriggersStream(request, optionsopt) → {Stream}

Equivalent to method.name.toCamelCase(), but returns a NodeJS Stream object.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Parent resource name.

The format of this value varies depending on whether you have specified a processing location:

  • Projects scope, location specified: projects/{project_id}/locations/{location_id}
  • Projects scope, no location specified (defaults to global): projects/{project_id}

The following example parent string specifies a parent project with the identifier example-project, and specifies the europe-west3 location for processing data:

  parent=projects/example-project/locations/europe-west3
pageToken string

Page token to continue retrieval. Comes from the previous call to ListJobTriggers. order_by field must not change for subsequent calls.

pageSize number

Size of the page. This value can be limited by a server.

orderBy string

Comma-separated list of triggeredJob fields to order by, followed by asc or desc postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant.

Example: name asc,update_time, create_time desc

Supported fields are:

  • create_time: corresponds to the time the JobTrigger was created.
  • update_time: corresponds to the time the JobTrigger was last updated.
  • last_run_time: corresponds to the last time the JobTrigger ran.
  • name: corresponds to the JobTrigger's name.
  • display_name: corresponds to the JobTrigger's display name.
  • status: corresponds to JobTrigger's status.
filter string

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 triggers:
    • status - HEALTHY|PAUSED|CANCELLED
    • inspected_storage - DATASTORE|CLOUD_STORAGE|BIGQUERY
    • 'last_run_time` - RFC 3339 formatted timestamp, surrounded by quotation marks. Nanoseconds are ignored.
    • 'error_count' - Number of errors that have occurred while running.
  • The operator must be = or != for status and inspected_storage.

Examples:

  • inspected_storage = cloud_storage AND status = HEALTHY
  • inspected_storage = cloud_storage OR inspected_storage = bigquery
  • inspected_storage = cloud_storage AND (state = PAUSED OR state = HEALTHY)
  • last_run_time > "2017-12-12T00:00:00+00:00"

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

type google.privacy.dlp.v2.DlpJobType

The type of jobs. Will use DlpJobType.INSPECT if not set.

locationId string

Deprecated. This field has no effect.

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Stream

An object stream which emits an object representing JobTrigger on 'data' event. The client library will perform auto-pagination by default: it will call the API as many times as needed. Note that it can affect your quota. We recommend using listJobTriggersAsync() method described below for async iteration which you can stop as needed. Please see the documentation for more details and examples.

listLocationsAsync(request, optionsopt) → {Object}

Lists information about the supported locations for this service. Returns an iterable object.

for-await-of syntax is used with the iterable to get response elements on-demand.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
name string

The resource that owns the locations collection, if applicable.

filter string

The standard list filter.

pageSize number

The standard list page size.

pageToken string

The standard list page token.

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Object

An iterable Object that allows async iteration. When you iterate the returned iterable, each element will be an object representing Location. The API will be called under the hood as needed, once per the page, so you can stop the iteration when you don't need more results. Please see the documentation for more details and examples.

Example
```
const iterable = client.listLocationsAsync(request);
for await (const response of iterable) {
  // process response
}
```

listProjectDataProfilesAsync(request, optionsopt) → {Object}

Equivalent to listProjectDataProfiles, but returns an iterable object.

for-await-of syntax is used with the iterable to get response elements on-demand.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. organizations/{org_id}/locations/{loc_id}

pageToken string

Page token to continue retrieval.

pageSize number

Size of the page. This value can be limited by the server. If zero, server returns a page of max size 100.

orderBy string

Comma-separated list of fields to order by, followed by asc or desc postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed.

Examples:

  • project_id
  • sensitivity_level desc

Supported fields are:

  • project_id: Google Cloud project ID
  • sensitivity_level: How sensitive the data in a project is, at most.
  • data_risk_level: How much risk is associated with this data.
  • profile_last_generated: When the profile was last updated in epoch seconds.
filter string

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:
    • sensitivity_level - HIGH|MODERATE|LOW
    • data_risk_level - HIGH|MODERATE|LOW
    • status_code - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
  • The operator must be = or !=.

Examples:

  • project_id = 12345 AND status_code = 1
  • project_id = 12345 AND sensitivity_level = HIGH

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

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Object

An iterable Object that allows async iteration. When you iterate the returned iterable, each element will be an object representing ProjectDataProfile. The API will be called under the hood as needed, once per the page, so you can stop the iteration when you don't need more results. Please see the documentation for more details and examples.

Example
  /**
   * This snippet has been automatically generated and should be regarded as a code template only.
   * It will require modifications to work.
   * It may require correct/in-range values for request initialization.
   * TODO(developer): Uncomment these variables before running the sample.
   */
  /**
   *  Required. organizations/{org_id}/locations/{loc_id}
   */
  // const parent = 'abc123'
  /**
   *  Page token to continue retrieval.
   */
  // const pageToken = 'abc123'
  /**
   *  Size of the page. This value can be limited by the server. If zero, server
   *  returns a page of max size 100.
   */
  // const pageSize = 1234
  /**
   *  Comma-separated list of fields to order by, followed by `asc` or `desc`
   *  postfix. This list is case insensitive. The default sorting order is
   *  ascending. Redundant space characters are insignificant. Only one order
   *  field at a time is allowed.
   *  Examples:
   *  * `project_id`
   *  * `sensitivity_level desc`
   *  Supported fields are:
   *  - `project_id`: Google Cloud project ID
   *  - `sensitivity_level`: How sensitive the data in a project is, at most.
   *  - `data_risk_level`: How much risk is associated with this data.
   *  - `profile_last_generated`: When the profile was last updated in epoch
   *  seconds.
   */
  // const orderBy = 'abc123'
  /**
   *  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:
   *      - `sensitivity_level` - HIGH|MODERATE|LOW
   *      - `data_risk_level` - HIGH|MODERATE|LOW
   *      - `status_code` - an RPC status code as defined in
   *      https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
   *  * The operator must be `=` or `!=`.
   *  Examples:
   *  * `project_id = 12345 AND status_code = 1`
   *  * `project_id = 12345 AND sensitivity_level = HIGH`
   *  The length of this field should be no more than 500 characters.
   */
  // const filter = 'abc123'

  // Imports the Dlp library
  const {DlpServiceClient} = require('@google-cloud/dlp').v2;

  // Instantiates a client
  const dlpClient = new DlpServiceClient();

  async function callListProjectDataProfiles() {
    // Construct request
    const request = {
      parent,
    };

    // Run request
    const iterable = dlpClient.listProjectDataProfilesAsync(request);
    for await (const response of iterable) {
        console.log(response);
    }
  }

  callListProjectDataProfiles();

listProjectDataProfilesStream(request, optionsopt) → {Stream}

Equivalent to method.name.toCamelCase(), but returns a NodeJS Stream object.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. organizations/{org_id}/locations/{loc_id}

pageToken string

Page token to continue retrieval.

pageSize number

Size of the page. This value can be limited by the server. If zero, server returns a page of max size 100.

orderBy string

Comma-separated list of fields to order by, followed by asc or desc postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed.

Examples:

  • project_id
  • sensitivity_level desc

Supported fields are:

  • project_id: Google Cloud project ID
  • sensitivity_level: How sensitive the data in a project is, at most.
  • data_risk_level: How much risk is associated with this data.
  • profile_last_generated: When the profile was last updated in epoch seconds.
filter string

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:
    • sensitivity_level - HIGH|MODERATE|LOW
    • data_risk_level - HIGH|MODERATE|LOW
    • status_code - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
  • The operator must be = or !=.

Examples:

  • project_id = 12345 AND status_code = 1
  • project_id = 12345 AND sensitivity_level = HIGH

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

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Stream

An object stream which emits an object representing ProjectDataProfile on 'data' event. The client library will perform auto-pagination by default: it will call the API as many times as needed. Note that it can affect your quota. We recommend using listProjectDataProfilesAsync() method described below for async iteration which you can stop as needed. Please see the documentation for more details and examples.

listStoredInfoTypesAsync(request, optionsopt) → {Object}

Equivalent to listStoredInfoTypes, but returns an iterable object.

for-await-of syntax is used with the iterable to get response elements on-demand.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Parent resource name.

The format of this value varies depending on the scope of the request (project or organization) and whether you have specified a processing location:

  • Projects scope, location specified: projects/{project_id}/locations/{location_id}
  • Projects scope, no location specified (defaults to global): projects/{project_id}

The following example parent string specifies a parent project with the identifier example-project, and specifies the europe-west3 location for processing data:

  parent=projects/example-project/locations/europe-west3
pageToken string

Page token to continue retrieval. Comes from the previous call to ListStoredInfoTypes.

pageSize number

Size of the page. This value can be limited by the server. If zero server returns a page of max size 100.

orderBy string

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

Example: name asc, display_name, create_time desc

Supported fields are:

  • create_time: corresponds to the time the most recent version of the resource was created.
  • state: corresponds to the state of the resource.
  • name: corresponds to resource name.
  • display_name: corresponds to info type's display name.
locationId string

Deprecated. This field has no effect.

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Object

An iterable Object that allows async iteration. When you iterate the returned iterable, each element will be an object representing StoredInfoType. The API will be called under the hood as needed, once per the page, so you can stop the iteration when you don't need more results. Please see the documentation for more details and examples.

Example
  /**
   * This snippet has been automatically generated and should be regarded as a code template only.
   * It will require modifications to work.
   * It may require correct/in-range values for request initialization.
   * TODO(developer): Uncomment these variables before running the sample.
   */
  /**
   *  Required. Parent resource name.
   *  The format of this value varies depending on the scope of the request
   *  (project or organization) and whether you have specified a processing
   *  location (https://cloud.google.com/sensitive-data-protection/docs/specifying-location):
   *  + Projects scope, location specified:
   *    `projects/{project_id}/locations/{location_id}`
   *  + Projects scope, no location specified (defaults to global):
   *    `projects/{project_id}`
   *  The following example `parent` string specifies a parent project with the
   *  identifier `example-project`, and specifies the `europe-west3` location
   *  for processing data:
   *      parent=projects/example-project/locations/europe-west3
   */
  // const parent = 'abc123'
  /**
   *  Page token to continue retrieval. Comes from the previous call
   *  to `ListStoredInfoTypes`.
   */
  // const pageToken = 'abc123'
  /**
   *  Size of the page. This value can be limited by the server. If zero server
   *  returns a page of max size 100.
   */
  // const pageSize = 1234
  /**
   *  Comma-separated list of fields to order by,
   *  followed by `asc` or `desc` postfix. This list is case insensitive. The
   *  default sorting order is ascending. Redundant space characters are
   *  insignificant.
   *  Example: `name asc, display_name, create_time desc`
   *  Supported fields are:
   *  - `create_time`: corresponds to the time the most recent version of the
   *  resource was created.
   *  - `state`: corresponds to the state of the resource.
   *  - `name`: corresponds to resource name.
   *  - `display_name`: corresponds to info type's display name.
   */
  // const orderBy = 'abc123'

  // Imports the Dlp library
  const {DlpServiceClient} = require('@google-cloud/dlp').v2;

  // Instantiates a client
  const dlpClient = new DlpServiceClient();

  async function callListStoredInfoTypes() {
    // Construct request
    const request = {
      parent,
    };

    // Run request
    const iterable = dlpClient.listStoredInfoTypesAsync(request);
    for await (const response of iterable) {
        console.log(response);
    }
  }

  callListStoredInfoTypes();

listStoredInfoTypesStream(request, optionsopt) → {Stream}

Equivalent to method.name.toCamelCase(), but returns a NodeJS Stream object.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Parent resource name.

The format of this value varies depending on the scope of the request (project or organization) and whether you have specified a processing location:

  • Projects scope, location specified: projects/{project_id}/locations/{location_id}
  • Projects scope, no location specified (defaults to global): projects/{project_id}

The following example parent string specifies a parent project with the identifier example-project, and specifies the europe-west3 location for processing data:

  parent=projects/example-project/locations/europe-west3
pageToken string

Page token to continue retrieval. Comes from the previous call to ListStoredInfoTypes.

pageSize number

Size of the page. This value can be limited by the server. If zero server returns a page of max size 100.

orderBy string

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

Example: name asc, display_name, create_time desc

Supported fields are:

  • create_time: corresponds to the time the most recent version of the resource was created.
  • state: corresponds to the state of the resource.
  • name: corresponds to resource name.
  • display_name: corresponds to info type's display name.
locationId string

Deprecated. This field has no effect.

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Stream

An object stream which emits an object representing StoredInfoType on 'data' event. The client library will perform auto-pagination by default: it will call the API as many times as needed. Note that it can affect your quota. We recommend using listStoredInfoTypesAsync() method described below for async iteration which you can stop as needed. Please see the documentation for more details and examples.

listTableDataProfilesAsync(request, optionsopt) → {Object}

Equivalent to listTableDataProfiles, but returns an iterable object.

for-await-of syntax is used with the iterable to get response elements on-demand.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Resource name of the organization or project, for example organizations/433245324/locations/europe or projects/project-id/locations/asia.

pageToken string

Page token to continue retrieval.

pageSize number

Size of the page. This value can be limited by the server. If zero, server returns a page of max size 100.

orderBy string

Comma-separated list of fields to order by, followed by asc or desc postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed.

Examples:

  • project_id asc
  • table_id
  • sensitivity_level desc

Supported fields are:

  • project_id: The Google Cloud project ID.
  • dataset_id: The ID of a BigQuery dataset.
  • table_id: The ID of a BigQuery table.
  • sensitivity_level: How sensitive the data in a table is, at most.
  • data_risk_level: How much risk is associated with this data.
  • profile_last_generated: When the profile was last updated in epoch seconds.
  • last_modified: The last time the resource was modified.
  • resource_visibility: Visibility restriction for this resource.
  • row_count: Number of rows in this resource.
filter string

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:
    • project_id - The Google Cloud project ID.
    • dataset_id - The BigQuery dataset ID.
    • table_id - The ID of the BigQuery table.
    • sensitivity_level - HIGH|MODERATE|LOW
    • data_risk_level - HIGH|MODERATE|LOW
    • resource_visibility: PUBLIC|RESTRICTED
    • status_code - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
  • The operator must be = or !=.

Examples:

  • project_id = 12345 AND status_code = 1
  • project_id = 12345 AND sensitivity_level = HIGH
  • project_id = 12345 AND resource_visibility = PUBLIC

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

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Object

An iterable Object that allows async iteration. When you iterate the returned iterable, each element will be an object representing TableDataProfile. The API will be called under the hood as needed, once per the page, so you can stop the iteration when you don't need more results. Please see the documentation for more details and examples.

Example
  /**
   * This snippet has been automatically generated and should be regarded as a code template only.
   * It will require modifications to work.
   * It may require correct/in-range values for request initialization.
   * TODO(developer): Uncomment these variables before running the sample.
   */
  /**
   *  Required. Resource name of the organization or project, for
   *  example `organizations/433245324/locations/europe` or
   *  `projects/project-id/locations/asia`.
   */
  // const parent = 'abc123'
  /**
   *  Page token to continue retrieval.
   */
  // const pageToken = 'abc123'
  /**
   *  Size of the page. This value can be limited by the server. If zero, server
   *  returns a page of max size 100.
   */
  // const pageSize = 1234
  /**
   *  Comma-separated list of fields to order by, followed by `asc` or `desc`
   *  postfix. This list is case insensitive. The default sorting order is
   *  ascending. Redundant space characters are insignificant. Only one order
   *  field at a time is allowed.
   *  Examples:
   *  * `project_id asc`
   *  * `table_id`
   *  * `sensitivity_level desc`
   *  Supported fields are:
   *  - `project_id`: The Google Cloud project ID.
   *  - `dataset_id`: The ID of a BigQuery dataset.
   *  - `table_id`: The ID of a BigQuery table.
   *  - `sensitivity_level`: How sensitive the data in a table is, at most.
   *  - `data_risk_level`: How much risk is associated with this data.
   *  - `profile_last_generated`: When the profile was last updated in epoch
   *  seconds.
   *  - `last_modified`: The last time the resource was modified.
   *  - `resource_visibility`: Visibility restriction for this resource.
   *  - `row_count`: Number of rows in this resource.
   */
  // const orderBy = 'abc123'
  /**
   *  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:
   *      - `project_id` - The Google Cloud project ID.
   *      - `dataset_id` - The BigQuery dataset ID.
   *      - `table_id` - The ID of the BigQuery table.
   *      - `sensitivity_level` - HIGH|MODERATE|LOW
   *      - `data_risk_level` - HIGH|MODERATE|LOW
   *      - `resource_visibility`: PUBLIC|RESTRICTED
   *      - `status_code` - an RPC status code as defined in
   *      https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
   *  * The operator must be `=` or `!=`.
   *  Examples:
   *  * `project_id = 12345 AND status_code = 1`
   *  * `project_id = 12345 AND sensitivity_level = HIGH`
   *  * `project_id = 12345 AND resource_visibility = PUBLIC`
   *  The length of this field should be no more than 500 characters.
   */
  // const filter = 'abc123'

  // Imports the Dlp library
  const {DlpServiceClient} = require('@google-cloud/dlp').v2;

  // Instantiates a client
  const dlpClient = new DlpServiceClient();

  async function callListTableDataProfiles() {
    // Construct request
    const request = {
      parent,
    };

    // Run request
    const iterable = dlpClient.listTableDataProfilesAsync(request);
    for await (const response of iterable) {
        console.log(response);
    }
  }

  callListTableDataProfiles();

listTableDataProfilesStream(request, optionsopt) → {Stream}

Equivalent to method.name.toCamelCase(), but returns a NodeJS Stream object.

Parameters:
Name Type Attributes Description
request Object

The request object that will be sent.

Properties
Name Type Description
parent string

Required. Resource name of the organization or project, for example organizations/433245324/locations/europe or projects/project-id/locations/asia.

pageToken string

Page token to continue retrieval.

pageSize number

Size of the page. This value can be limited by the server. If zero, server returns a page of max size 100.

orderBy string

Comma-separated list of fields to order by, followed by asc or desc postfix. This list is case insensitive. The default sorting order is ascending. Redundant space characters are insignificant. Only one order field at a time is allowed.

Examples:

  • project_id asc
  • table_id
  • sensitivity_level desc

Supported fields are:

  • project_id: The Google Cloud project ID.
  • dataset_id: The ID of a BigQuery dataset.
  • table_id: The ID of a BigQuery table.
  • sensitivity_level: How sensitive the data in a table is, at most.
  • data_risk_level: How much risk is associated with this data.
  • profile_last_generated: When the profile was last updated in epoch seconds.
  • last_modified: The last time the resource was modified.
  • resource_visibility: Visibility restriction for this resource.
  • row_count: Number of rows in this resource.
filter string

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:
    • project_id - The Google Cloud project ID.
    • dataset_id - The BigQuery dataset ID.
    • table_id - The ID of the BigQuery table.
    • sensitivity_level - HIGH|MODERATE|LOW
    • data_risk_level - HIGH|MODERATE|LOW
    • resource_visibility: PUBLIC|RESTRICTED
    • status_code - an RPC status code as defined in https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto
  • The operator must be = or !=.

Examples:

  • project_id = 12345 AND status_code = 1
  • project_id = 12345 AND sensitivity_level = HIGH
  • project_id = 12345 AND resource_visibility = PUBLIC

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

options object <optional>

Call options. See CallOptions for more details.

Returns:
Type Description
Stream

An object stream which emits an object representing TableDataProfile on 'data' event. The client library will perform auto-pagination by default: it will call the API as many times as needed. Note that it can affect your quota. We recommend using listTableDataProfilesAsync() method described below for async iteration which you can stop as needed. Please see the documentation for more details and examples.

locationPath(project, location) → {string}

Return a fully-qualified location resource name string.

Parameters:
Name Type Description
project string
location string
Returns:
Type Description
string

Resource name string.

matchColumnDataProfileFromOrganizationLocationColumnDataProfileName(organizationLocationColumnDataProfileName) → {string}

Parse the column_data_profile from OrganizationLocationColumnDataProfile resource.

Parameters:
Name Type Description
organizationLocationColumnDataProfileName string

A fully-qualified path representing organization_location_column_data_profile resource.

Returns:
Type Description
string

A string representing the column_data_profile.

matchColumnDataProfileFromProjectLocationColumnDataProfileName(projectLocationColumnDataProfileName) → {string}

Parse the column_data_profile from ProjectLocationColumnDataProfile resource.

Parameters:
Name Type Description
projectLocationColumnDataProfileName string

A fully-qualified path representing project_location_column_data_profile resource.

Returns:
Type Description
string

A string representing the column_data_profile.

matchConnectionFromOrganizationLocationConnectionName(organizationLocationConnectionName) → {string}

Parse the connection from OrganizationLocationConnection resource.

Parameters:
Name Type Description
organizationLocationConnectionName string

A fully-qualified path representing organization_location_connection resource.

Returns:
Type Description
string

A string representing the connection.

matchConnectionFromProjectLocationConnectionName(projectLocationConnectionName) → {string}

Parse the connection from ProjectLocationConnection resource.

Parameters:
Name Type Description
projectLocationConnectionName string

A fully-qualified path representing project_location_connection resource.

Returns:
Type Description
string

A string representing the connection.

matchDeidentifyTemplateFromOrganizationDeidentifyTemplateName(organizationDeidentifyTemplateName) → {string}

Parse the deidentify_template from OrganizationDeidentifyTemplate resource.

Parameters:
Name Type Description
organizationDeidentifyTemplateName string

A fully-qualified path representing organization_deidentify_template resource.

Returns:
Type Description
string

A string representing the deidentify_template.

matchDeidentifyTemplateFromOrganizationLocationDeidentifyTemplateName(organizationLocationDeidentifyTemplateName) → {string}

Parse the deidentify_template from OrganizationLocationDeidentifyTemplate resource.

Parameters:
Name Type Description
organizationLocationDeidentifyTemplateName string

A fully-qualified path representing organization_location_deidentify_template resource.

Returns:
Type Description
string

A string representing the deidentify_template.

matchDeidentifyTemplateFromProjectDeidentifyTemplateName(projectDeidentifyTemplateName) → {string}

Parse the deidentify_template from ProjectDeidentifyTemplate resource.

Parameters:
Name Type Description
projectDeidentifyTemplateName string

A fully-qualified path representing project_deidentify_template resource.

Returns:
Type Description
string

A string representing the deidentify_template.

matchDeidentifyTemplateFromProjectLocationDeidentifyTemplateName(projectLocationDeidentifyTemplateName) → {string}

Parse the deidentify_template from ProjectLocationDeidentifyTemplate resource.

Parameters:
Name Type Description
projectLocationDeidentifyTemplateName string

A fully-qualified path representing project_location_deidentify_template resource.

Returns:
Type Description
string

A string representing the deidentify_template.

matchDiscoveryConfigFromDiscoveryConfigName(discoveryConfigName) → {string}

Parse the discovery_config from DiscoveryConfig resource.

Parameters:
Name Type Description
discoveryConfigName string

A fully-qualified path representing DiscoveryConfig resource.

Returns:
Type Description
string

A string representing the discovery_config.

matchDlpJobFromProjectDlpJobName(projectDlpJobName) → {string}

Parse the dlp_job from ProjectDlpJob resource.

Parameters:
Name Type Description
projectDlpJobName string

A fully-qualified path representing project_dlp_job resource.

Returns:
Type Description
string

A string representing the dlp_job.

matchDlpJobFromProjectLocationDlpJobName(projectLocationDlpJobName) → {string}

Parse the dlp_job from ProjectLocationDlpJob resource.

Parameters:
Name Type Description
projectLocationDlpJobName string

A fully-qualified path representing project_location_dlp_job resource.

Returns:
Type Description
string

A string representing the dlp_job.

matchFileStoreDataProfileFromOrganizationLocationFileStoreDataProfileName(organizationLocationFileStoreDataProfileName) → {string}

Parse the file_store_data_profile from OrganizationLocationFileStoreDataProfile resource.

Parameters:
Name Type Description
organizationLocationFileStoreDataProfileName string

A fully-qualified path representing organization_location_file_store_data_profile resource.

Returns:
Type Description
string

A string representing the file_store_data_profile.

matchFileStoreDataProfileFromProjectLocationFileStoreDataProfileName(projectLocationFileStoreDataProfileName) → {string}

Parse the file_store_data_profile from ProjectLocationFileStoreDataProfile resource.

Parameters:
Name Type Description
projectLocationFileStoreDataProfileName string

A fully-qualified path representing project_location_file_store_data_profile resource.

Returns:
Type Description
string

A string representing the file_store_data_profile.

matchFindingFromFindingName(findingName) → {string}

Parse the finding from Finding resource.

Parameters:
Name Type Description
findingName string

A fully-qualified path representing Finding resource.

Returns:
Type Description
string

A string representing the finding.

matchInspectTemplateFromOrganizationInspectTemplateName(organizationInspectTemplateName) → {string}

Parse the inspect_template from OrganizationInspectTemplate resource.

Parameters:
Name Type Description
organizationInspectTemplateName string

A fully-qualified path representing organization_inspect_template resource.

Returns:
Type Description
string

A string representing the inspect_template.

matchInspectTemplateFromOrganizationLocationInspectTemplateName(organizationLocationInspectTemplateName) → {string}

Parse the inspect_template from OrganizationLocationInspectTemplate resource.

Parameters:
Name Type Description
organizationLocationInspectTemplateName string

A fully-qualified path representing organization_location_inspect_template resource.

Returns:
Type Description
string

A string representing the inspect_template.

matchInspectTemplateFromProjectInspectTemplateName(projectInspectTemplateName) → {string}

Parse the inspect_template from ProjectInspectTemplate resource.

Parameters:
Name Type Description
projectInspectTemplateName string

A fully-qualified path representing project_inspect_template resource.

Returns:
Type Description
string

A string representing the inspect_template.

matchInspectTemplateFromProjectLocationInspectTemplateName(projectLocationInspectTemplateName) → {string}

Parse the inspect_template from ProjectLocationInspectTemplate resource.

Parameters:
Name Type Description
projectLocationInspectTemplateName string

A fully-qualified path representing project_location_inspect_template resource.

Returns:
Type Description
string

A string representing the inspect_template.

matchJobTriggerFromProjectJobTriggerName(projectJobTriggerName) → {string}

Parse the job_trigger from ProjectJobTrigger resource.

Parameters:
Name Type Description
projectJobTriggerName string

A fully-qualified path representing project_job_trigger resource.

Returns:
Type Description
string

A string representing the job_trigger.

matchJobTriggerFromProjectLocationJobTriggerName(projectLocationJobTriggerName) → {string}

Parse the job_trigger from ProjectLocationJobTrigger resource.

Parameters:
Name Type Description
projectLocationJobTriggerName string

A fully-qualified path representing project_location_job_trigger resource.

Returns:
Type Description
string

A string representing the job_trigger.

matchLocationFromDiscoveryConfigName(discoveryConfigName) → {string}

Parse the location from DiscoveryConfig resource.

Parameters:
Name Type Description
discoveryConfigName string

A fully-qualified path representing DiscoveryConfig resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromFindingName(findingName) → {string}

Parse the location from Finding resource.

Parameters:
Name Type Description
findingName string

A fully-qualified path representing Finding resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromLocationName(locationName) → {string}

Parse the location from Location resource.

Parameters:
Name Type Description
locationName string

A fully-qualified path representing Location resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromOrganizationLocationColumnDataProfileName(organizationLocationColumnDataProfileName) → {string}

Parse the location from OrganizationLocationColumnDataProfile resource.

Parameters:
Name Type Description
organizationLocationColumnDataProfileName string

A fully-qualified path representing organization_location_column_data_profile resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromOrganizationLocationConnectionName(organizationLocationConnectionName) → {string}

Parse the location from OrganizationLocationConnection resource.

Parameters:
Name Type Description
organizationLocationConnectionName string

A fully-qualified path representing organization_location_connection resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromOrganizationLocationDeidentifyTemplateName(organizationLocationDeidentifyTemplateName) → {string}

Parse the location from OrganizationLocationDeidentifyTemplate resource.

Parameters:
Name Type Description
organizationLocationDeidentifyTemplateName string

A fully-qualified path representing organization_location_deidentify_template resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromOrganizationLocationFileStoreDataProfileName(organizationLocationFileStoreDataProfileName) → {string}

Parse the location from OrganizationLocationFileStoreDataProfile resource.

Parameters:
Name Type Description
organizationLocationFileStoreDataProfileName string

A fully-qualified path representing organization_location_file_store_data_profile resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromOrganizationLocationInspectTemplateName(organizationLocationInspectTemplateName) → {string}

Parse the location from OrganizationLocationInspectTemplate resource.

Parameters:
Name Type Description
organizationLocationInspectTemplateName string

A fully-qualified path representing organization_location_inspect_template resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromOrganizationLocationName(organizationLocationName) → {string}

Parse the location from OrganizationLocation resource.

Parameters:
Name Type Description
organizationLocationName string

A fully-qualified path representing OrganizationLocation resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromOrganizationLocationProjectDataProfileName(organizationLocationProjectDataProfileName) → {string}

Parse the location from OrganizationLocationProjectDataProfile resource.

Parameters:
Name Type Description
organizationLocationProjectDataProfileName string

A fully-qualified path representing organization_location_project_data_profile resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromOrganizationLocationStoredInfoTypeName(organizationLocationStoredInfoTypeName) → {string}

Parse the location from OrganizationLocationStoredInfoType resource.

Parameters:
Name Type Description
organizationLocationStoredInfoTypeName string

A fully-qualified path representing organization_location_stored_info_type resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromOrganizationLocationTableDataProfileName(organizationLocationTableDataProfileName) → {string}

Parse the location from OrganizationLocationTableDataProfile resource.

Parameters:
Name Type Description
organizationLocationTableDataProfileName string

A fully-qualified path representing organization_location_table_data_profile resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromProjectLocationColumnDataProfileName(projectLocationColumnDataProfileName) → {string}

Parse the location from ProjectLocationColumnDataProfile resource.

Parameters:
Name Type Description
projectLocationColumnDataProfileName string

A fully-qualified path representing project_location_column_data_profile resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromProjectLocationConnectionName(projectLocationConnectionName) → {string}

Parse the location from ProjectLocationConnection resource.

Parameters:
Name Type Description
projectLocationConnectionName string

A fully-qualified path representing project_location_connection resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromProjectLocationDeidentifyTemplateName(projectLocationDeidentifyTemplateName) → {string}

Parse the location from ProjectLocationDeidentifyTemplate resource.

Parameters:
Name Type Description
projectLocationDeidentifyTemplateName string

A fully-qualified path representing project_location_deidentify_template resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromProjectLocationDlpJobName(projectLocationDlpJobName) → {string}

Parse the location from ProjectLocationDlpJob resource.

Parameters:
Name Type Description
projectLocationDlpJobName string

A fully-qualified path representing project_location_dlp_job resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromProjectLocationFileStoreDataProfileName(projectLocationFileStoreDataProfileName) → {string}

Parse the location from ProjectLocationFileStoreDataProfile resource.

Parameters:
Name Type Description
projectLocationFileStoreDataProfileName string

A fully-qualified path representing project_location_file_store_data_profile resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromProjectLocationInspectTemplateName(projectLocationInspectTemplateName) → {string}

Parse the location from ProjectLocationInspectTemplate resource.

Parameters:
Name Type Description
projectLocationInspectTemplateName string

A fully-qualified path representing project_location_inspect_template resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromProjectLocationJobTriggerName(projectLocationJobTriggerName) → {string}

Parse the location from ProjectLocationJobTrigger resource.

Parameters:
Name Type Description
projectLocationJobTriggerName string

A fully-qualified path representing project_location_job_trigger resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromProjectLocationProjectDataProfileName(projectLocationProjectDataProfileName) → {string}

Parse the location from ProjectLocationProjectDataProfile resource.

Parameters:
Name Type Description
projectLocationProjectDataProfileName string

A fully-qualified path representing project_location_project_data_profile resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromProjectLocationStoredInfoTypeName(projectLocationStoredInfoTypeName) → {string}

Parse the location from ProjectLocationStoredInfoType resource.

Parameters:
Name Type Description
projectLocationStoredInfoTypeName string

A fully-qualified path representing project_location_stored_info_type resource.

Returns:
Type Description
string

A string representing the location.

matchLocationFromProjectLocationTableDataProfileName(projectLocationTableDataProfileName) → {string}

Parse the location from ProjectLocationTableDataProfile resource.

Parameters:
Name Type Description
projectLocationTableDataProfileName string

A fully-qualified path representing project_location_table_data_profile resource.

Returns:
Type Description
string

A string representing the location.

matchOrganizationFromOrganizationDeidentifyTemplateName(organizationDeidentifyTemplateName) → {string}

Parse the organization from OrganizationDeidentifyTemplate resource.

Parameters:
Name Type Description
organizationDeidentifyTemplateName string

A fully-qualified path representing organization_deidentify_template resource.

Returns:
Type Description
string

A string representing the organization.

matchOrganizationFromOrganizationInspectTemplateName(organizationInspectTemplateName) → {string}

Parse the organization from OrganizationInspectTemplate resource.

Parameters:
Name Type Description
organizationInspectTemplateName string

A fully-qualified path representing organization_inspect_template resource.

Returns:
Type Description
string

A string representing the organization.

matchOrganizationFromOrganizationLocationColumnDataProfileName(organizationLocationColumnDataProfileName) → {string}

Parse the organization from OrganizationLocationColumnDataProfile resource.

Parameters:
Name Type Description
organizationLocationColumnDataProfileName string

A fully-qualified path representing organization_location_column_data_profile resource.

Returns:
Type Description
string

A string representing the organization.

matchOrganizationFromOrganizationLocationConnectionName(organizationLocationConnectionName) → {string}

Parse the organization from OrganizationLocationConnection resource.

Parameters:
Name Type Description
organizationLocationConnectionName string

A fully-qualified path representing organization_location_connection resource.

Returns:
Type Description
string

A string representing the organization.

matchOrganizationFromOrganizationLocationDeidentifyTemplateName(organizationLocationDeidentifyTemplateName) → {string}

Parse the organization from OrganizationLocationDeidentifyTemplate resource.

Parameters:
Name Type Description
organizationLocationDeidentifyTemplateName string

A fully-qualified path representing organization_location_deidentify_template resource.

Returns:
Type Description
string

A string representing the organization.

matchOrganizationFromOrganizationLocationFileStoreDataProfileName(organizationLocationFileStoreDataProfileName) → {string}

Parse the organization from OrganizationLocationFileStoreDataProfile resource.

Parameters:
Name Type Description
organizationLocationFileStoreDataProfileName string

A fully-qualified path representing organization_location_file_store_data_profile resource.

Returns:
Type Description
string

A string representing the organization.

matchOrganizationFromOrganizationLocationInspectTemplateName(organizationLocationInspectTemplateName) → {string}

Parse the organization from OrganizationLocationInspectTemplate resource.

Parameters:
Name Type Description
organizationLocationInspectTemplateName string

A fully-qualified path representing organization_location_inspect_template resource.

Returns:
Type Description
string

A string representing the organization.

matchOrganizationFromOrganizationLocationName(organizationLocationName) → {string}

Parse the organization from OrganizationLocation resource.

Parameters:
Name Type Description
organizationLocationName string

A fully-qualified path representing OrganizationLocation resource.

Returns:
Type Description
string

A string representing the organization.

matchOrganizationFromOrganizationLocationProjectDataProfileName(organizationLocationProjectDataProfileName) → {string}

Parse the organization from OrganizationLocationProjectDataProfile resource.

Parameters:
Name Type Description