@google-cloud/dlp 5.4.0 → 5.5.0

package/build/src/v2/dlp_service_client.js

@@ -157,6 +157,7 @@ class DlpServiceClient {
         // identifiers to uniquely identify resources within the API.
         // Create useful helper objects for these.
         this.pathTemplates = {
+            connectionPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/connections/{connection}'),
             discoveryConfigPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/discoveryConfigs/{discovery_config}'),
             findingPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}/findings/{finding}'),
             locationPathTemplate: new this._gaxModule.PathTemplate('projects/{project}/locations/{location}'),
@@ -200,6 +201,8 @@ class DlpServiceClient {
             listProjectDataProfiles: new this._gaxModule.PageDescriptor('pageToken', 'nextPageToken', 'projectDataProfiles'),
             listTableDataProfiles: new this._gaxModule.PageDescriptor('pageToken', 'nextPageToken', 'tableDataProfiles'),
             listColumnDataProfiles: new this._gaxModule.PageDescriptor('pageToken', 'nextPageToken', 'columnDataProfiles'),
+            listConnections: new this._gaxModule.PageDescriptor('pageToken', 'nextPageToken', 'connections'),
+            searchConnections: new this._gaxModule.PageDescriptor('pageToken', 'nextPageToken', 'connections'),
         };
         // Put together the default options sent with requests.
         this._defaults = this._gaxGrpc.constructSettings('google.privacy.dlp.v2.DlpService', gapicConfig, opts.clientConfig || {}, { 'x-goog-api-client': clientHeader.join(' ') });
@@ -278,8 +281,15 @@ class DlpServiceClient {
             'getProjectDataProfile',
             'getTableDataProfile',
             'getColumnDataProfile',
+            'deleteTableDataProfile',
             'hybridInspectDlpJob',
             'finishDlpJob',
+            'createConnection',
+            'getConnection',
+            'listConnections',
+            'searchConnections',
+            'deleteConnection',
+            'updateConnection',
         ];
         for (const methodName of dlpServiceStubMethods) {
             const callPromise = this.dlpServiceStub.then(stub => (...args) => {
@@ -1071,6 +1081,27 @@ class DlpServiceClient {
         this.initialize();
         return this.innerApiCalls.getColumnDataProfile(request, options, callback);
     }
+    deleteTableDataProfile(request, optionsOrCallback, callback) {
+        var _a;
+        request = request || {};
+        let options;
+        if (typeof optionsOrCallback === 'function' && callback === undefined) {
+            callback = optionsOrCallback;
+            options = {};
+        }
+        else {
+            options = optionsOrCallback;
+        }
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                name: (_a = request.name) !== null && _a !== void 0 ? _a : '',
+            });
+        this.initialize();
+        return this.innerApiCalls.deleteTableDataProfile(request, options, callback);
+    }
     hybridInspectDlpJob(request, optionsOrCallback, callback) {
         var _a;
         request = request || {};
@@ -1113,6 +1144,90 @@ class DlpServiceClient {
         this.initialize();
         return this.innerApiCalls.finishDlpJob(request, options, callback);
     }
+    createConnection(request, optionsOrCallback, callback) {
+        var _a;
+        request = request || {};
+        let options;
+        if (typeof optionsOrCallback === 'function' && callback === undefined) {
+            callback = optionsOrCallback;
+            options = {};
+        }
+        else {
+            options = optionsOrCallback;
+        }
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                parent: (_a = request.parent) !== null && _a !== void 0 ? _a : '',
+            });
+        this.initialize();
+        return this.innerApiCalls.createConnection(request, options, callback);
+    }
+    getConnection(request, optionsOrCallback, callback) {
+        var _a;
+        request = request || {};
+        let options;
+        if (typeof optionsOrCallback === 'function' && callback === undefined) {
+            callback = optionsOrCallback;
+            options = {};
+        }
+        else {
+            options = optionsOrCallback;
+        }
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                name: (_a = request.name) !== null && _a !== void 0 ? _a : '',
+            });
+        this.initialize();
+        return this.innerApiCalls.getConnection(request, options, callback);
+    }
+    deleteConnection(request, optionsOrCallback, callback) {
+        var _a;
+        request = request || {};
+        let options;
+        if (typeof optionsOrCallback === 'function' && callback === undefined) {
+            callback = optionsOrCallback;
+            options = {};
+        }
+        else {
+            options = optionsOrCallback;
+        }
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                name: (_a = request.name) !== null && _a !== void 0 ? _a : '',
+            });
+        this.initialize();
+        return this.innerApiCalls.deleteConnection(request, options, callback);
+    }
+    updateConnection(request, optionsOrCallback, callback) {
+        var _a;
+        request = request || {};
+        let options;
+        if (typeof optionsOrCallback === 'function' && callback === undefined) {
+            callback = optionsOrCallback;
+            options = {};
+        }
+        else {
+            options = optionsOrCallback;
+        }
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                name: (_a = request.name) !== null && _a !== void 0 ? _a : '',
+            });
+        this.initialize();
+        return this.innerApiCalls.updateConnection(request, options, callback);
+    }
     listInspectTemplates(request, optionsOrCallback, callback) {
         var _a;
         request = request || {};
@@ -2245,7 +2360,7 @@ class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `project_id`: GCP project ID
+     *   - `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
@@ -2323,7 +2438,7 @@ class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `project_id`: GCP project ID
+     *   - `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
@@ -2424,7 +2539,7 @@ class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `project_id`: The GCP project ID.
+     *   - `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.
@@ -2444,7 +2559,7 @@ class DlpServiceClient {
      *   sequence of restrictions implicitly uses `AND`.
      *   * A restriction has the form of `{field} {operator} {value}`.
      *   * Supported fields/values:
-     *       - `project_id` - The GCP project ID.
+     *       - `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
@@ -2515,7 +2630,7 @@ class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `project_id`: The GCP project ID.
+     *   - `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.
@@ -2535,7 +2650,7 @@ class DlpServiceClient {
      *   sequence of restrictions implicitly uses `AND`.
      *   * A restriction has the form of `{field} {operator} {value}`.
      *   * Supported fields/values:
-     *       - `project_id` - The GCP project ID.
+     *       - `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
@@ -2783,6 +2898,218 @@ class DlpServiceClient {
         this.initialize();
         return this.descriptors.page.listColumnDataProfiles.asyncIterate(this.innerApiCalls['listColumnDataProfiles'], request, callSettings);
     }
+    listConnections(request, optionsOrCallback, callback) {
+        var _a;
+        request = request || {};
+        let options;
+        if (typeof optionsOrCallback === 'function' && callback === undefined) {
+            callback = optionsOrCallback;
+            options = {};
+        }
+        else {
+            options = optionsOrCallback;
+        }
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                parent: (_a = request.parent) !== null && _a !== void 0 ? _a : '',
+            });
+        this.initialize();
+        return this.innerApiCalls.listConnections(request, options, callback);
+    }
+    /**
+     * Equivalent to `method.name.toCamelCase()`, but returns a NodeJS Stream object.
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.parent
+     *   Required. Parent name, for example:
+     *   `projects/project-id/locations/global`.
+     * @param {number} [request.pageSize]
+     *   Optional. Number of results per page, max 1000.
+     * @param {string} [request.pageToken]
+     *   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.
+     * @param {string} [request.filter]
+     *   Optional. * Supported fields/values
+     *       - `state` - MISSING|AVAILABLE|ERROR
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Stream}
+     *   An object stream which emits an object representing {@link protos.google.privacy.dlp.v2.Connection|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 {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
+     *   for more details and examples.
+     */
+    listConnectionsStream(request, options) {
+        var _a;
+        request = request || {};
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                parent: (_a = request.parent) !== null && _a !== void 0 ? _a : '',
+            });
+        const defaultCallSettings = this._defaults['listConnections'];
+        const callSettings = defaultCallSettings.merge(options);
+        this.initialize();
+        return this.descriptors.page.listConnections.createStream(this.innerApiCalls.listConnections, request, callSettings);
+    }
+    /**
+     * Equivalent to `listConnections`, but returns an iterable object.
+     *
+     * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.parent
+     *   Required. Parent name, for example:
+     *   `projects/project-id/locations/global`.
+     * @param {number} [request.pageSize]
+     *   Optional. Number of results per page, max 1000.
+     * @param {string} [request.pageToken]
+     *   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.
+     * @param {string} [request.filter]
+     *   Optional. * Supported fields/values
+     *       - `state` - MISSING|AVAILABLE|ERROR
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Object}
+     *   An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
+     *   When you iterate the returned iterable, each element will be an object representing
+     *   {@link protos.google.privacy.dlp.v2.Connection|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 {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
+     *   for more details and examples.
+     * @example <caption>include:samples/generated/v2/dlp_service.list_connections.js</caption>
+     * region_tag:dlp_v2_generated_DlpService_ListConnections_async
+     */
+    listConnectionsAsync(request, options) {
+        var _a;
+        request = request || {};
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                parent: (_a = request.parent) !== null && _a !== void 0 ? _a : '',
+            });
+        const defaultCallSettings = this._defaults['listConnections'];
+        const callSettings = defaultCallSettings.merge(options);
+        this.initialize();
+        return this.descriptors.page.listConnections.asyncIterate(this.innerApiCalls['listConnections'], request, callSettings);
+    }
+    searchConnections(request, optionsOrCallback, callback) {
+        var _a;
+        request = request || {};
+        let options;
+        if (typeof optionsOrCallback === 'function' && callback === undefined) {
+            callback = optionsOrCallback;
+            options = {};
+        }
+        else {
+            options = optionsOrCallback;
+        }
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                parent: (_a = request.parent) !== null && _a !== void 0 ? _a : '',
+            });
+        this.initialize();
+        return this.innerApiCalls.searchConnections(request, options, callback);
+    }
+    /**
+     * Equivalent to `method.name.toCamelCase()`, but returns a NodeJS Stream object.
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.parent
+     *   Required. Parent name, typically an organization, without location.
+     *   For example: `organizations/12345678`.
+     * @param {number} [request.pageSize]
+     *   Optional. Number of results per page, max 1000.
+     * @param {string} [request.pageToken]
+     *   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.
+     * @param {string} [request.filter]
+     *   Optional. * Supported fields/values
+     *       - `state` - MISSING|AVAILABLE|ERROR
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Stream}
+     *   An object stream which emits an object representing {@link protos.google.privacy.dlp.v2.Connection|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 `searchConnectionsAsync()`
+     *   method described below for async iteration which you can stop as needed.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
+     *   for more details and examples.
+     */
+    searchConnectionsStream(request, options) {
+        var _a;
+        request = request || {};
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                parent: (_a = request.parent) !== null && _a !== void 0 ? _a : '',
+            });
+        const defaultCallSettings = this._defaults['searchConnections'];
+        const callSettings = defaultCallSettings.merge(options);
+        this.initialize();
+        return this.descriptors.page.searchConnections.createStream(this.innerApiCalls.searchConnections, request, callSettings);
+    }
+    /**
+     * Equivalent to `searchConnections`, but returns an iterable object.
+     *
+     * `for`-`await`-`of` syntax is used with the iterable to get response elements on-demand.
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.parent
+     *   Required. Parent name, typically an organization, without location.
+     *   For example: `organizations/12345678`.
+     * @param {number} [request.pageSize]
+     *   Optional. Number of results per page, max 1000.
+     * @param {string} [request.pageToken]
+     *   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.
+     * @param {string} [request.filter]
+     *   Optional. * Supported fields/values
+     *       - `state` - MISSING|AVAILABLE|ERROR
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Object}
+     *   An iterable Object that allows {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols | async iteration }.
+     *   When you iterate the returned iterable, each element will be an object representing
+     *   {@link protos.google.privacy.dlp.v2.Connection|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 {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
+     *   for more details and examples.
+     * @example <caption>include:samples/generated/v2/dlp_service.search_connections.js</caption>
+     * region_tag:dlp_v2_generated_DlpService_SearchConnections_async
+     */
+    searchConnectionsAsync(request, options) {
+        var _a;
+        request = request || {};
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                parent: (_a = request.parent) !== null && _a !== void 0 ? _a : '',
+            });
+        const defaultCallSettings = this._defaults['searchConnections'];
+        const callSettings = defaultCallSettings.merge(options);
+        this.initialize();
+        return this.descriptors.page.searchConnections.asyncIterate(this.innerApiCalls['searchConnections'], request, callSettings);
+    }
     /**
      * Gets information about a location.
      *
@@ -2841,6 +3168,54 @@ class DlpServiceClient {
     // --------------------
     // -- Path templates --
     // --------------------
+    /**
+     * Return a fully-qualified connection resource name string.
+     *
+     * @param {string} project
+     * @param {string} location
+     * @param {string} connection
+     * @returns {string} Resource name string.
+     */
+    connectionPath(project, location, connection) {
+        return this.pathTemplates.connectionPathTemplate.render({
+            project: project,
+            location: location,
+            connection: connection,
+        });
+    }
+    /**
+     * Parse the project from Connection resource.
+     *
+     * @param {string} connectionName
+     *   A fully-qualified path representing Connection resource.
+     * @returns {string} A string representing the project.
+     */
+    matchProjectFromConnectionName(connectionName) {
+        return this.pathTemplates.connectionPathTemplate.match(connectionName)
+            .project;
+    }
+    /**
+     * Parse the location from Connection resource.
+     *
+     * @param {string} connectionName
+     *   A fully-qualified path representing Connection resource.
+     * @returns {string} A string representing the location.
+     */
+    matchLocationFromConnectionName(connectionName) {
+        return this.pathTemplates.connectionPathTemplate.match(connectionName)
+            .location;
+    }
+    /**
+     * Parse the connection from Connection resource.
+     *
+     * @param {string} connectionName
+     *   A fully-qualified path representing Connection resource.
+     * @returns {string} A string representing the connection.
+     */
+    matchConnectionFromConnectionName(connectionName) {
+        return this.pathTemplates.connectionPathTemplate.match(connectionName)
+            .connection;
+    }
     /**
      * Return a fully-qualified discoveryConfig resource name string.
      *

package/build/src/v2/dlp_service_client_config.json

@@ -235,6 +235,10 @@
                     "retry_codes_name": "idempotent",
                     "retry_params_name": "default"
                 },
+                "DeleteTableDataProfile": {
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default"
+                },
                 "HybridInspectDlpJob": {
                     "timeout_millis": 300000,
                     "retry_codes_name": "non_idempotent",
@@ -244,6 +248,30 @@
                     "timeout_millis": 300000,
                     "retry_codes_name": "non_idempotent",
                     "retry_params_name": "default"
+                },
+                "CreateConnection": {
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default"
+                },
+                "GetConnection": {
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default"
+                },
+                "ListConnections": {
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default"
+                },
+                "SearchConnections": {
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default"
+                },
+                "DeleteConnection": {
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default"
+                },
+                "UpdateConnection": {
+                    "retry_codes_name": "non_idempotent",
+                    "retry_params_name": "default"
                 }
             }
         }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@google-cloud/dlp",
   "description": "DLP API client for Node.js",
-  "version": "5.4.0",
+  "version": "5.5.0",
   "license": "Apache-2.0",
   "author": "Google Inc",
   "engines": {