@google-cloud/dlp 4.1.0 → 4.2.0

package/build/src/v2/dlp_service_client.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
-import * as gax from 'google-gax';
-import { Callback, CallOptions, Descriptors, ClientOptions, PaginationCallback } from 'google-gax';
+import type * as gax from 'google-gax';
+import type { Callback, CallOptions, Descriptors, ClientOptions, PaginationCallback, LocationsClient, LocationProtos } from 'google-gax';
 import { Transform } from 'stream';
 import * as protos from '../../protos/protos';
 /**
@@ -30,6 +30,7 @@ export declare class DlpServiceClient {
     innerApiCalls: {
         [name: string]: Function;
     };
+    locationsClient: LocationsClient;
     pathTemplates: {
         [name: string]: gax.PathTemplate;
     };
@@ -68,8 +69,15 @@ export declare class DlpServiceClient {
      *     Pass "rest" to use HTTP/1.1 REST API instead of gRPC.
      *     For more information, please check the
      *     {@link https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#http11-rest-api-mode documentation}.
+     * @param {gax} [gaxInstance]: 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: 'rest'}, gax);
+     *     ```
      */
-    constructor(opts?: ClientOptions);
+    constructor(opts?: ClientOptions, gaxInstance?: typeof gax | typeof gax.fallback);
     /**
      * Initialize the client.
      * Performs asynchronous operations (such as authentication) and prepares the client.
@@ -369,7 +377,7 @@ export declare class DlpServiceClient {
     reidentifyContent(request: protos.google.privacy.dlp.v2.IReidentifyContentRequest, options: CallOptions, callback: Callback<protos.google.privacy.dlp.v2.IReidentifyContentResponse, protos.google.privacy.dlp.v2.IReidentifyContentRequest | null | undefined, {} | null | undefined>): void;
     reidentifyContent(request: protos.google.privacy.dlp.v2.IReidentifyContentRequest, callback: Callback<protos.google.privacy.dlp.v2.IReidentifyContentResponse, protos.google.privacy.dlp.v2.IReidentifyContentRequest | null | undefined, {} | null | undefined>): void;
     /**
-     * Returns a list of the sensitive information types that the DLP API
+     * Returns a list of the sensitive information types that DLP API
      * supports. See https://cloud.google.com/dlp/docs/infotypes-reference to
      * learn more.
      *
@@ -408,7 +416,7 @@ export declare class DlpServiceClient {
     listInfoTypes(request: protos.google.privacy.dlp.v2.IListInfoTypesRequest, options: CallOptions, callback: Callback<protos.google.privacy.dlp.v2.IListInfoTypesResponse, protos.google.privacy.dlp.v2.IListInfoTypesRequest | null | undefined, {} | null | undefined>): void;
     listInfoTypes(request: protos.google.privacy.dlp.v2.IListInfoTypesRequest, callback: Callback<protos.google.privacy.dlp.v2.IListInfoTypesResponse, protos.google.privacy.dlp.v2.IListInfoTypesRequest | null | undefined, {} | null | undefined>): void;
     /**
-     * Creates an InspectTemplate for re-using frequently used configuration
+     * Creates an InspectTemplate for reusing frequently used configuration
      * for inspecting content, images, and storage.
      * See https://cloud.google.com/dlp/docs/creating-templates to learn more.
      *
@@ -547,7 +555,7 @@ export declare class DlpServiceClient {
     deleteInspectTemplate(request: protos.google.privacy.dlp.v2.IDeleteInspectTemplateRequest, options: CallOptions, callback: Callback<protos.google.protobuf.IEmpty, protos.google.privacy.dlp.v2.IDeleteInspectTemplateRequest | null | undefined, {} | null | undefined>): void;
     deleteInspectTemplate(request: protos.google.privacy.dlp.v2.IDeleteInspectTemplateRequest, callback: Callback<protos.google.protobuf.IEmpty, protos.google.privacy.dlp.v2.IDeleteInspectTemplateRequest | null | undefined, {} | null | undefined>): void;
     /**
-     * Creates a DeidentifyTemplate for re-using frequently used configuration
+     * Creates a DeidentifyTemplate for reusing frequently used configuration
      * for de-identifying content, images, and storage.
      * See https://cloud.google.com/dlp/docs/creating-templates-deid to learn
      * more.
@@ -961,7 +969,7 @@ export declare class DlpServiceClient {
     getDlpJob(request: protos.google.privacy.dlp.v2.IGetDlpJobRequest, callback: Callback<protos.google.privacy.dlp.v2.IDlpJob, protos.google.privacy.dlp.v2.IGetDlpJobRequest | null | undefined, {} | null | undefined>): void;
     /**
      * Deletes a long-running DlpJob. This method indicates that the client is
-     * no longer interested in the DlpJob result. The job will be cancelled if
+     * no longer interested in the DlpJob result. The job will be canceled if
      * possible.
      * See https://cloud.google.com/dlp/docs/inspecting-storage and
      * https://cloud.google.com/dlp/docs/compute-risk-analysis to learn more.
@@ -1245,7 +1253,7 @@ export declare class DlpServiceClient {
      *   Page token to continue retrieval. Comes from previous call
      *   to `ListInspectTemplates`.
      * @param {number} request.pageSize
-     *   Size of the page, can be limited by server. If zero server returns
+     *   Size of the page, can be limited by the server. If zero server returns
      *   a page of max size 100.
      * @param {string} request.orderBy
      *   Comma separated list of fields to order by,
@@ -1257,10 +1265,10 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the template was created.
-     *   - `update_time`: corresponds to time the template was last updated.
-     *   - `name`: corresponds to template's name.
-     *   - `display_name`: corresponds to template's display name.
+     *   - `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.
      * @param {string} request.locationId
      *   Deprecated. This field has no effect.
      * @param {object} [options]
@@ -1312,7 +1320,7 @@ export declare class DlpServiceClient {
      *   Page token to continue retrieval. Comes from previous call
      *   to `ListInspectTemplates`.
      * @param {number} request.pageSize
-     *   Size of the page, can be limited by server. If zero server returns
+     *   Size of the page, can be limited by the server. If zero server returns
      *   a page of max size 100.
      * @param {string} request.orderBy
      *   Comma separated list of fields to order by,
@@ -1324,10 +1332,10 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the template was created.
-     *   - `update_time`: corresponds to time the template was last updated.
-     *   - `name`: corresponds to template's name.
-     *   - `display_name`: corresponds to template's display name.
+     *   - `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.
      * @param {string} request.locationId
      *   Deprecated. This field has no effect.
      * @param {object} [options]
@@ -1374,7 +1382,7 @@ export declare class DlpServiceClient {
      *   Page token to continue retrieval. Comes from previous call
      *   to `ListInspectTemplates`.
      * @param {number} request.pageSize
-     *   Size of the page, can be limited by server. If zero server returns
+     *   Size of the page, can be limited by the server. If zero server returns
      *   a page of max size 100.
      * @param {string} request.orderBy
      *   Comma separated list of fields to order by,
@@ -1386,10 +1394,10 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the template was created.
-     *   - `update_time`: corresponds to time the template was last updated.
-     *   - `name`: corresponds to template's name.
-     *   - `display_name`: corresponds to template's display name.
+     *   - `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.
      * @param {string} request.locationId
      *   Deprecated. This field has no effect.
      * @param {object} [options]
@@ -1438,7 +1446,7 @@ export declare class DlpServiceClient {
      *   Page token to continue retrieval. Comes from previous call
      *   to `ListDeidentifyTemplates`.
      * @param {number} request.pageSize
-     *   Size of the page, can be limited by server. If zero server returns
+     *   Size of the page, can be limited by the server. If zero server returns
      *   a page of max size 100.
      * @param {string} request.orderBy
      *   Comma separated list of fields to order by,
@@ -1450,10 +1458,10 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the template was created.
-     *   - `update_time`: corresponds to time the template was last updated.
-     *   - `name`: corresponds to template's name.
-     *   - `display_name`: corresponds to template's display name.
+     *   - `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.
      * @param {string} request.locationId
      *   Deprecated. This field has no effect.
      * @param {object} [options]
@@ -1505,7 +1513,7 @@ export declare class DlpServiceClient {
      *   Page token to continue retrieval. Comes from previous call
      *   to `ListDeidentifyTemplates`.
      * @param {number} request.pageSize
-     *   Size of the page, can be limited by server. If zero server returns
+     *   Size of the page, can be limited by the server. If zero server returns
      *   a page of max size 100.
      * @param {string} request.orderBy
      *   Comma separated list of fields to order by,
@@ -1517,10 +1525,10 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the template was created.
-     *   - `update_time`: corresponds to time the template was last updated.
-     *   - `name`: corresponds to template's name.
-     *   - `display_name`: corresponds to template's display name.
+     *   - `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.
      * @param {string} request.locationId
      *   Deprecated. This field has no effect.
      * @param {object} [options]
@@ -1567,7 +1575,7 @@ export declare class DlpServiceClient {
      *   Page token to continue retrieval. Comes from previous call
      *   to `ListDeidentifyTemplates`.
      * @param {number} request.pageSize
-     *   Size of the page, can be limited by server. If zero server returns
+     *   Size of the page, can be limited by the server. If zero server returns
      *   a page of max size 100.
      * @param {string} request.orderBy
      *   Comma separated list of fields to order by,
@@ -1579,10 +1587,10 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the template was created.
-     *   - `update_time`: corresponds to time the template was last updated.
-     *   - `name`: corresponds to template's name.
-     *   - `display_name`: corresponds to template's display name.
+     *   - `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.
      * @param {string} request.locationId
      *   Deprecated. This field has no effect.
      * @param {object} [options]
@@ -1638,11 +1646,11 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the JobTrigger was created.
-     *   - `update_time`: corresponds to time the JobTrigger was last updated.
+     *   - `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 JobTrigger's name.
-     *   - `display_name`: corresponds to JobTrigger's display name.
+     *   - `name`: corresponds to the JobTrigger's name.
+     *   - `display_name`: corresponds to the JobTrigger's display name.
      *   - `status`: corresponds to JobTrigger's status.
      * @param {string} request.filter
      *   Allows filtering.
@@ -1730,11 +1738,11 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the JobTrigger was created.
-     *   - `update_time`: corresponds to time the JobTrigger was last updated.
+     *   - `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 JobTrigger's name.
-     *   - `display_name`: corresponds to JobTrigger's display name.
+     *   - `name`: corresponds to the JobTrigger's name.
+     *   - `display_name`: corresponds to the JobTrigger's display name.
      *   - `status`: corresponds to JobTrigger's status.
      * @param {string} request.filter
      *   Allows filtering.
@@ -1817,11 +1825,11 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the JobTrigger was created.
-     *   - `update_time`: corresponds to time the JobTrigger was last updated.
+     *   - `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 JobTrigger's name.
-     *   - `display_name`: corresponds to JobTrigger's display name.
+     *   - `name`: corresponds to the JobTrigger's name.
+     *   - `display_name`: corresponds to the JobTrigger's display name.
      *   - `status`: corresponds to JobTrigger's status.
      * @param {string} request.filter
      *   Allows filtering.
@@ -1902,13 +1910,13 @@ export declare class DlpServiceClient {
      *   * Supported fields/values for inspect jobs:
      *       - `state` - PENDING|RUNNING|CANCELED|FINISHED|FAILED
      *       - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
-     *       - `trigger_name` - The resource name of the trigger that created job.
-     *       - 'end_time` - Corresponds to time the job finished.
-     *       - 'start_time` - Corresponds to time the job finished.
+     *       - `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 time the job finished.
-     *       - 'start_time` - Corresponds to time the job finished.
+     *       - 'end_time` - Corresponds to the time the job finished.
+     *       - 'start_time` - Corresponds to the time the job finished.
      *   * The operator must be `=` or `!=`.
      *
      *   Examples:
@@ -1935,9 +1943,9 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the job was created.
-     *   - `end_time`: corresponds to time the job ended.
-     *   - `name`: corresponds to job's name.
+     *   - `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`
      * @param {string} request.locationId
      *   Deprecated. This field has no effect.
@@ -1994,13 +2002,13 @@ export declare class DlpServiceClient {
      *   * Supported fields/values for inspect jobs:
      *       - `state` - PENDING|RUNNING|CANCELED|FINISHED|FAILED
      *       - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
-     *       - `trigger_name` - The resource name of the trigger that created job.
-     *       - 'end_time` - Corresponds to time the job finished.
-     *       - 'start_time` - Corresponds to time the job finished.
+     *       - `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 time the job finished.
-     *       - 'start_time` - Corresponds to time the job finished.
+     *       - 'end_time` - Corresponds to the time the job finished.
+     *       - 'start_time` - Corresponds to the time the job finished.
      *   * The operator must be `=` or `!=`.
      *
      *   Examples:
@@ -2027,9 +2035,9 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the job was created.
-     *   - `end_time`: corresponds to time the job ended.
-     *   - `name`: corresponds to job's name.
+     *   - `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`
      * @param {string} request.locationId
      *   Deprecated. This field has no effect.
@@ -2081,13 +2089,13 @@ export declare class DlpServiceClient {
      *   * Supported fields/values for inspect jobs:
      *       - `state` - PENDING|RUNNING|CANCELED|FINISHED|FAILED
      *       - `inspected_storage` - DATASTORE|CLOUD_STORAGE|BIGQUERY
-     *       - `trigger_name` - The resource name of the trigger that created job.
-     *       - 'end_time` - Corresponds to time the job finished.
-     *       - 'start_time` - Corresponds to time the job finished.
+     *       - `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 time the job finished.
-     *       - 'start_time` - Corresponds to time the job finished.
+     *       - 'end_time` - Corresponds to the time the job finished.
+     *       - 'start_time` - Corresponds to the time the job finished.
      *   * The operator must be `=` or `!=`.
      *
      *   Examples:
@@ -2114,9 +2122,9 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the job was created.
-     *   - `end_time`: corresponds to time the job ended.
-     *   - `name`: corresponds to job's name.
+     *   - `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`
      * @param {string} request.locationId
      *   Deprecated. This field has no effect.
@@ -2152,10 +2160,6 @@ export declare class DlpServiceClient {
      *     `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
      *   + Projects scope, no location specified (defaults to global):<br/>
      *     `projects/`<var>PROJECT_ID</var>
-     *   + Organizations scope, location specified:<br/>
-     *     `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
-     *   + Organizations scope, no location specified (defaults to global):<br/>
-     *     `organizations/`<var>ORG_ID</var>
      *
      *   The following example `parent` string specifies a parent project with the
      *   identifier `example-project`, and specifies the `europe-west3` location
@@ -2166,7 +2170,7 @@ export declare class DlpServiceClient {
      *   Page token to continue retrieval. Comes from previous call
      *   to `ListStoredInfoTypes`.
      * @param {number} request.pageSize
-     *   Size of the page, can be limited by server. If zero server returns
+     *   Size of the page, can be limited by the server. If zero server returns
      *   a page of max size 100.
      * @param {string} request.orderBy
      *   Comma separated list of fields to order by,
@@ -2178,7 +2182,7 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the most recent version of the
+     *   - `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.
@@ -2220,10 +2224,6 @@ export declare class DlpServiceClient {
      *     `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
      *   + Projects scope, no location specified (defaults to global):<br/>
      *     `projects/`<var>PROJECT_ID</var>
-     *   + Organizations scope, location specified:<br/>
-     *     `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
-     *   + Organizations scope, no location specified (defaults to global):<br/>
-     *     `organizations/`<var>ORG_ID</var>
      *
      *   The following example `parent` string specifies a parent project with the
      *   identifier `example-project`, and specifies the `europe-west3` location
@@ -2234,7 +2234,7 @@ export declare class DlpServiceClient {
      *   Page token to continue retrieval. Comes from previous call
      *   to `ListStoredInfoTypes`.
      * @param {number} request.pageSize
-     *   Size of the page, can be limited by server. If zero server returns
+     *   Size of the page, can be limited by the server. If zero server returns
      *   a page of max size 100.
      * @param {string} request.orderBy
      *   Comma separated list of fields to order by,
@@ -2246,7 +2246,7 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the most recent version of the
+     *   - `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.
@@ -2283,10 +2283,6 @@ export declare class DlpServiceClient {
      *     `projects/`<var>PROJECT_ID</var>`/locations/`<var>LOCATION_ID</var>
      *   + Projects scope, no location specified (defaults to global):<br/>
      *     `projects/`<var>PROJECT_ID</var>
-     *   + Organizations scope, location specified:<br/>
-     *     `organizations/`<var>ORG_ID</var>`/locations/`<var>LOCATION_ID</var>
-     *   + Organizations scope, no location specified (defaults to global):<br/>
-     *     `organizations/`<var>ORG_ID</var>
      *
      *   The following example `parent` string specifies a parent project with the
      *   identifier `example-project`, and specifies the `europe-west3` location
@@ -2297,7 +2293,7 @@ export declare class DlpServiceClient {
      *   Page token to continue retrieval. Comes from previous call
      *   to `ListStoredInfoTypes`.
      * @param {number} request.pageSize
-     *   Size of the page, can be limited by server. If zero server returns
+     *   Size of the page, can be limited by the server. If zero server returns
      *   a page of max size 100.
      * @param {string} request.orderBy
      *   Comma separated list of fields to order by,
@@ -2309,7 +2305,7 @@ export declare class DlpServiceClient {
      *
      *   Supported fields are:
      *
-     *   - `create_time`: corresponds to time the most recent version of the
+     *   - `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.
@@ -2330,6 +2326,59 @@ export declare class DlpServiceClient {
      * region_tag:dlp_v2_generated_DlpService_ListStoredInfoTypes_async
      */
     listStoredInfoTypesAsync(request?: protos.google.privacy.dlp.v2.IListStoredInfoTypesRequest, options?: CallOptions): AsyncIterable<protos.google.privacy.dlp.v2.IStoredInfoType>;
+    /**
+     * Gets information about a location.
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   Resource name for the location.
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Promise} - The promise which resolves to an array.
+     *   The first element of the array is an object representing [Location]{@link google.cloud.location.Location}.
+     *   Please see the
+     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
+     *   for more details and examples.
+     * @example
+     * ```
+     * const [response] = await client.getLocation(request);
+     * ```
+     */
+    getLocation(request: LocationProtos.google.cloud.location.IGetLocationRequest, options?: gax.CallOptions | Callback<LocationProtos.google.cloud.location.ILocation, LocationProtos.google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>, callback?: Callback<LocationProtos.google.cloud.location.ILocation, LocationProtos.google.cloud.location.IGetLocationRequest | null | undefined, {} | null | undefined>): Promise<LocationProtos.google.cloud.location.ILocation>;
+    /**
+     * 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.
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   The resource that owns the locations collection, if applicable.
+     * @param {string} request.filter
+     *   The standard list filter.
+     * @param {number} request.pageSize
+     *   The standard list page size.
+     * @param {string} request.pageToken
+     *   The standard list page token.
+     * @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 [async iteration](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols).
+     *   When you iterate the returned iterable, each element will be an object representing
+     *   [Location]{@link google.cloud.location.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](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
+     *   for more details and examples.
+     * @example
+     * ```
+     * const iterable = client.listLocationsAsync(request);
+     * for await (const response of iterable) {
+     *   // process response
+     * }
+     * ```
+     */
+    listLocationsAsync(request: LocationProtos.google.cloud.location.IListLocationsRequest, options?: CallOptions): AsyncIterable<LocationProtos.google.cloud.location.ILocation>;
     /**
      * Return a fully-qualified finding resource name string.
      *