@google-cloud/dms 1.1.0 → 2.1.1

package/build/src/v1/data_migration_service_client.js

@@ -1,5 +1,5 @@
 "use strict";
-// Copyright 2021 Google LLC
+// Copyright 2022 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -18,8 +18,6 @@
 // ** All changes to this file may be overwritten. **
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DataMigrationServiceClient = void 0;
-/* global window */
-const gax = require("google-gax");
 const jsonProtos = require("../../protos/protos.json");
 /**
  * Client JSON configuration object, loaded from
@@ -27,7 +25,6 @@ const jsonProtos = require("../../protos/protos.json");
  * This file defines retry strategy and timeouts for all API methods in this library.
  */
 const gapicConfig = require("./data_migration_service_client_config.json");
-const google_gax_1 = require("google-gax");
 const version = require('../../../package.json').version;
 /**
  *  Database Migration service
@@ -40,7 +37,7 @@ class DataMigrationServiceClient {
      *
      * @param {object} [options] - The configuration object.
      * The options accepted by the constructor are described in detail
-     * in [this document](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#creating-the-client-instance).
+     * in [this document](https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#creating-the-client-instance).
      * The common options are:
      * @param {object} [options.credentials] - Credentials object.
      * @param {string} [options.credentials.client_email]
@@ -63,13 +60,19 @@ class DataMigrationServiceClient {
      *     API remote host.
      * @param {gax.ClientConfig} [options.clientConfig] - Client configuration override.
      *     Follows the structure of {@link gapicConfig}.
-     * @param {boolean} [options.fallback] - Use HTTP fallback mode.
-     *     In fallback mode, a special browser-compatible transport implementation is used
-     *     instead of gRPC transport. In browser context (if the `window` object is defined)
-     *     the fallback mode is enabled automatically; set `options.fallback` to `false`
-     *     if you need to override this behavior.
+     * @param {boolean | "rest"} [options.fallback] - Use HTTP fallback mode.
+     *     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 DataMigrationServiceClient({fallback: 'rest'}, gax);
+     *     ```
      */
-    constructor(opts) {
+    constructor(opts, gaxInstance) {
         var _a, _b;
         this._terminated = false;
         this.descriptors = {
@@ -90,8 +93,12 @@ class DataMigrationServiceClient {
         if (servicePath !== staticMembers.servicePath && !('scopes' in opts)) {
             opts['scopes'] = staticMembers.scopes;
         }
+        // Load google-gax module synchronously if needed
+        if (!gaxInstance) {
+            gaxInstance = require('google-gax');
+        }
         // Choose either gRPC or proto-over-HTTP implementation of google-gax.
-        this._gaxModule = opts.fallback ? gax.fallback : gax;
+        this._gaxModule = opts.fallback ? gaxInstance.fallback : gaxInstance;
         // Create a `gaxGrpc` object, with any grpc-specific options sent to the client.
         this._gaxGrpc = new this._gaxModule.GrpcClient(opts);
         // Save options to use in initialize() method.
@@ -145,11 +152,73 @@ class DataMigrationServiceClient {
         // This API contains "long-running operations", which return a
         // an Operation object that allows for tracking of the operation,
         // rather than holding a request open.
-        this.operationsClient = this._gaxModule
-            .lro({
+        const lroOptions = {
             auth: this.auth,
             grpc: 'grpc' in this._gaxGrpc ? this._gaxGrpc.grpc : undefined,
-        })
+        };
+        if (opts.fallback === 'rest') {
+            lroOptions.protoJson = protoFilesRoot;
+            lroOptions.httpRules = [
+                {
+                    selector: 'google.cloud.location.Locations.GetLocation',
+                    get: '/v1/{name=projects/*/locations/*}',
+                },
+                {
+                    selector: 'google.cloud.location.Locations.ListLocations',
+                    get: '/v1/{name=projects/*}/locations',
+                },
+                {
+                    selector: 'google.iam.v1.IAMPolicy.GetIamPolicy',
+                    get: '/v1/{resource=projects/*/locations/*/connectionProfiles/*}:getIamPolicy',
+                    additional_bindings: [
+                        {
+                            get: '/v1/{resource=projects/*/locations/*/migrationJobs/*}:getIamPolicy',
+                        },
+                    ],
+                },
+                {
+                    selector: 'google.iam.v1.IAMPolicy.SetIamPolicy',
+                    post: '/v1/{resource=projects/*/locations/*/connectionProfiles/*}:setIamPolicy',
+                    body: '*',
+                    additional_bindings: [
+                        {
+                            post: '/v1/{resource=projects/*/locations/*/migrationJobs/*}:setIamPolicy',
+                            body: '*',
+                        },
+                    ],
+                },
+                {
+                    selector: 'google.iam.v1.IAMPolicy.TestIamPermissions',
+                    post: '/v1/{resource=projects/*/locations/*/migrationJobs/*}:testIamPermissions',
+                    body: '*',
+                    additional_bindings: [
+                        {
+                            post: '/v1/{resource=projects/*/locations/*/connectionProfiles/*}:testIamPermissions',
+                            body: '*',
+                        },
+                    ],
+                },
+                {
+                    selector: 'google.longrunning.Operations.CancelOperation',
+                    post: '/v1/{name=projects/*/locations/*/operations/*}:cancel',
+                    body: '*',
+                },
+                {
+                    selector: 'google.longrunning.Operations.DeleteOperation',
+                    delete: '/v1/{name=projects/*/locations/*/operations/*}',
+                },
+                {
+                    selector: 'google.longrunning.Operations.GetOperation',
+                    get: '/v1/{name=projects/*/locations/*/operations/*}',
+                },
+                {
+                    selector: 'google.longrunning.Operations.ListOperations',
+                    get: '/v1/{name=projects/*/locations/*}/operations',
+                },
+            ];
+        }
+        this.operationsClient = this._gaxModule
+            .lro(lroOptions)
             .operationsClient(opts);
         const createMigrationJobResponse = protoFilesRoot.lookup('.google.cloud.clouddms.v1.MigrationJob');
         const createMigrationJobMetadata = protoFilesRoot.lookup('.google.cloud.clouddms.v1.OperationMetadata');
@@ -196,7 +265,7 @@ class DataMigrationServiceClient {
         // merely providing the destination and request information.
         this.innerApiCalls = {};
         // Add a warn function to the client constructor so it can be easily tested.
-        this.warn = gax.warn;
+        this.warn = this._gaxModule.warn;
     }
     /**
      * Initialize the client.
@@ -254,7 +323,7 @@ class DataMigrationServiceClient {
             const descriptor = this.descriptors.page[methodName] ||
                 this.descriptors.longrunning[methodName] ||
                 undefined;
-            const apiCall = this._gaxModule.createApiCall(callPromise, this._defaults[methodName], descriptor);
+            const apiCall = this._gaxModule.createApiCall(callPromise, this._defaults[methodName], descriptor, this._opts.fallback);
             this.innerApiCalls[methodName] = apiCall;
         }
         return this.dataMigrationServiceStub;
@@ -300,23 +369,6 @@ class DataMigrationServiceClient {
         }
         return this.auth.getProjectId();
     }
-    /**
-     * Gets details of a single migration job.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.name
-     *   Required. Name of the migration job resource to get.
-     * @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 [MigrationJob]{@link google.cloud.clouddms.v1.MigrationJob}.
-     *   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.getMigrationJob(request);
-     */
     getMigrationJob(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -331,38 +383,12 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 name: request.name || '',
             });
         this.initialize();
         return this.innerApiCalls.getMigrationJob(request, options, callback);
     }
-    /**
-     * Generate a SSH configuration script to configure the reverse SSH
-     * connectivity.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.migrationJob
-     *   Name of the migration job resource to generate the SSH script.
-     * @param {string} request.vm
-     *   Required. Bastion VM Instance name to use or to create.
-     * @param {google.cloud.clouddms.v1.VmCreationConfig} request.vmCreationConfig
-     *   The VM creation configuration
-     * @param {google.cloud.clouddms.v1.VmSelectionConfig} request.vmSelectionConfig
-     *   The VM selection configuration
-     * @param {number} request.vmPort
-     *   The port that will be open on the bastion host
-     * @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 [SshScript]{@link google.cloud.clouddms.v1.SshScript}.
-     *   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.generateSshScript(request);
-     */
     generateSshScript(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -377,29 +403,12 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 migration_job: request.migrationJob || '',
             });
         this.initialize();
         return this.innerApiCalls.generateSshScript(request, options, callback);
     }
-    /**
-     * Gets details of a single connection profile.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.name
-     *   Required. Name of the connection profile resource to get.
-     * @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 [ConnectionProfile]{@link google.cloud.clouddms.v1.ConnectionProfile}.
-     *   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.getConnectionProfile(request);
-     */
     getConnectionProfile(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -414,46 +423,12 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 name: request.name || '',
             });
         this.initialize();
         return this.innerApiCalls.getConnectionProfile(request, options, callback);
     }
-    /**
-     * Creates a new migration job in a given project and location.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.parent
-     *   Required. The parent, which owns this collection of migration jobs.
-     * @param {string} request.migrationJobId
-     *   Required. The ID of the instance to create.
-     * @param {google.cloud.clouddms.v1.MigrationJob} request.migrationJob
-     *   Required. Represents a [migration
-     *   job](https://cloud.google.com/database-migration/docs/reference/rest/v1/projects.locations.migrationJobs)
-     *   object.
-     * @param {string} request.requestId
-     *   A unique id used to identify the request. If the server receives two
-     *   requests with the same id, then the second request will be ignored.
-     *
-     *   It is recommended to always set this value to a UUID.
-     *
-     *   The id must contain only letters (a-z, A-Z), numbers (0-9), underscores
-     *   (_), and hyphens (-). The maximum length is 40 characters.
-     * @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
-     *   a long running operation. Its `promise()` method returns a promise
-     *   you can `await` for.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
-     *   for more details and examples.
-     * @example
-     * const [operation] = await client.createMigrationJob(request);
-     * const [response] = await operation.promise();
-     */
     createMigrationJob(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -468,7 +443,7 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 parent: request.parent || '',
             });
         this.initialize();
@@ -483,49 +458,15 @@ class DataMigrationServiceClient {
      *   Please see the
      *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
      *   for more details and examples.
-     * @example
-     * const decodedOperation = await checkCreateMigrationJobProgress(name);
-     * console.log(decodedOperation.result);
-     * console.log(decodedOperation.done);
-     * console.log(decodedOperation.metadata);
+     * @example <caption>include:samples/generated/v1/data_migration_service.create_migration_job.js</caption>
+     * region_tag:datamigration_v1_generated_DataMigrationService_CreateMigrationJob_async
      */
     async checkCreateMigrationJobProgress(name) {
-        const request = new google_gax_1.operationsProtos.google.longrunning.GetOperationRequest({ name });
+        const request = new this._gaxModule.operationsProtos.google.longrunning.GetOperationRequest({ name });
         const [operation] = await this.operationsClient.getOperation(request);
-        const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.createMigrationJob, gax.createDefaultBackoffSettings());
+        const decodeOperation = new this._gaxModule.Operation(operation, this.descriptors.longrunning.createMigrationJob, this._gaxModule.createDefaultBackoffSettings());
         return decodeOperation;
     }
-    /**
-     * Updates the parameters of a single migration job.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {google.protobuf.FieldMask} request.updateMask
-     *   Required. Field mask is used to specify the fields to be overwritten in the
-     *   migration job resource by the update.
-     * @param {google.cloud.clouddms.v1.MigrationJob} request.migrationJob
-     *   Required. The migration job parameters to update.
-     * @param {string} request.requestId
-     *   A unique id used to identify the request. If the server receives two
-     *   requests with the same id, then the second request will be ignored.
-     *
-     *   It is recommended to always set this value to a UUID.
-     *
-     *   The id must contain only letters (a-z, A-Z), numbers (0-9), underscores
-     *   (_), and hyphens (-). The maximum length is 40 characters.
-     * @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
-     *   a long running operation. Its `promise()` method returns a promise
-     *   you can `await` for.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
-     *   for more details and examples.
-     * @example
-     * const [operation] = await client.updateMigrationJob(request);
-     * const [response] = await operation.promise();
-     */
     updateMigrationJob(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -540,7 +481,7 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 'migration_job.name': request.migrationJob.name || '',
             });
         this.initialize();
@@ -555,50 +496,15 @@ class DataMigrationServiceClient {
      *   Please see the
      *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
      *   for more details and examples.
-     * @example
-     * const decodedOperation = await checkUpdateMigrationJobProgress(name);
-     * console.log(decodedOperation.result);
-     * console.log(decodedOperation.done);
-     * console.log(decodedOperation.metadata);
+     * @example <caption>include:samples/generated/v1/data_migration_service.update_migration_job.js</caption>
+     * region_tag:datamigration_v1_generated_DataMigrationService_UpdateMigrationJob_async
      */
     async checkUpdateMigrationJobProgress(name) {
-        const request = new google_gax_1.operationsProtos.google.longrunning.GetOperationRequest({ name });
+        const request = new this._gaxModule.operationsProtos.google.longrunning.GetOperationRequest({ name });
         const [operation] = await this.operationsClient.getOperation(request);
-        const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.updateMigrationJob, gax.createDefaultBackoffSettings());
+        const decodeOperation = new this._gaxModule.Operation(operation, this.descriptors.longrunning.updateMigrationJob, this._gaxModule.createDefaultBackoffSettings());
         return decodeOperation;
     }
-    /**
-     * Deletes a single migration job.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.name
-     *   Required. Name of the migration job resource to delete.
-     * @param {string} request.requestId
-     *   A unique id used to identify the request. If the server receives two
-     *   requests with the same id, then the second request will be ignored.
-     *
-     *   It is recommended to always set this value to a UUID.
-     *
-     *   The id must contain only letters (a-z, A-Z), numbers (0-9), underscores
-     *   (_), and hyphens (-). The maximum length is 40 characters.
-     * @param {boolean} request.force
-     *   The destination CloudSQL connection profile is always deleted with the
-     *   migration job. In case of force delete, the destination CloudSQL replica
-     *   database is also deleted.
-     * @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
-     *   a long running operation. Its `promise()` method returns a promise
-     *   you can `await` for.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
-     *   for more details and examples.
-     * @example
-     * const [operation] = await client.deleteMigrationJob(request);
-     * const [response] = await operation.promise();
-     */
     deleteMigrationJob(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -613,7 +519,7 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 name: request.name || '',
             });
         this.initialize();
@@ -628,38 +534,15 @@ class DataMigrationServiceClient {
      *   Please see the
      *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
      *   for more details and examples.
-     * @example
-     * const decodedOperation = await checkDeleteMigrationJobProgress(name);
-     * console.log(decodedOperation.result);
-     * console.log(decodedOperation.done);
-     * console.log(decodedOperation.metadata);
+     * @example <caption>include:samples/generated/v1/data_migration_service.delete_migration_job.js</caption>
+     * region_tag:datamigration_v1_generated_DataMigrationService_DeleteMigrationJob_async
      */
     async checkDeleteMigrationJobProgress(name) {
-        const request = new google_gax_1.operationsProtos.google.longrunning.GetOperationRequest({ name });
+        const request = new this._gaxModule.operationsProtos.google.longrunning.GetOperationRequest({ name });
         const [operation] = await this.operationsClient.getOperation(request);
-        const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.deleteMigrationJob, gax.createDefaultBackoffSettings());
+        const decodeOperation = new this._gaxModule.Operation(operation, this.descriptors.longrunning.deleteMigrationJob, this._gaxModule.createDefaultBackoffSettings());
         return decodeOperation;
     }
-    /**
-     * Start an already created migration job.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.name
-     *   Name of the migration job resource to start.
-     * @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
-     *   a long running operation. Its `promise()` method returns a promise
-     *   you can `await` for.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
-     *   for more details and examples.
-     * @example
-     * const [operation] = await client.startMigrationJob(request);
-     * const [response] = await operation.promise();
-     */
     startMigrationJob(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -674,7 +557,7 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 name: request.name || '',
             });
         this.initialize();
@@ -689,38 +572,15 @@ class DataMigrationServiceClient {
      *   Please see the
      *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
      *   for more details and examples.
-     * @example
-     * const decodedOperation = await checkStartMigrationJobProgress(name);
-     * console.log(decodedOperation.result);
-     * console.log(decodedOperation.done);
-     * console.log(decodedOperation.metadata);
+     * @example <caption>include:samples/generated/v1/data_migration_service.start_migration_job.js</caption>
+     * region_tag:datamigration_v1_generated_DataMigrationService_StartMigrationJob_async
      */
     async checkStartMigrationJobProgress(name) {
-        const request = new google_gax_1.operationsProtos.google.longrunning.GetOperationRequest({ name });
+        const request = new this._gaxModule.operationsProtos.google.longrunning.GetOperationRequest({ name });
         const [operation] = await this.operationsClient.getOperation(request);
-        const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.startMigrationJob, gax.createDefaultBackoffSettings());
+        const decodeOperation = new this._gaxModule.Operation(operation, this.descriptors.longrunning.startMigrationJob, this._gaxModule.createDefaultBackoffSettings());
         return decodeOperation;
     }
-    /**
-     * Stops a running migration job.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.name
-     *   Name of the migration job resource to stop.
-     * @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
-     *   a long running operation. Its `promise()` method returns a promise
-     *   you can `await` for.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
-     *   for more details and examples.
-     * @example
-     * const [operation] = await client.stopMigrationJob(request);
-     * const [response] = await operation.promise();
-     */
     stopMigrationJob(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -735,7 +595,7 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 name: request.name || '',
             });
         this.initialize();
@@ -750,39 +610,15 @@ class DataMigrationServiceClient {
      *   Please see the
      *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
      *   for more details and examples.
-     * @example
-     * const decodedOperation = await checkStopMigrationJobProgress(name);
-     * console.log(decodedOperation.result);
-     * console.log(decodedOperation.done);
-     * console.log(decodedOperation.metadata);
+     * @example <caption>include:samples/generated/v1/data_migration_service.stop_migration_job.js</caption>
+     * region_tag:datamigration_v1_generated_DataMigrationService_StopMigrationJob_async
      */
     async checkStopMigrationJobProgress(name) {
-        const request = new google_gax_1.operationsProtos.google.longrunning.GetOperationRequest({ name });
+        const request = new this._gaxModule.operationsProtos.google.longrunning.GetOperationRequest({ name });
         const [operation] = await this.operationsClient.getOperation(request);
-        const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.stopMigrationJob, gax.createDefaultBackoffSettings());
+        const decodeOperation = new this._gaxModule.Operation(operation, this.descriptors.longrunning.stopMigrationJob, this._gaxModule.createDefaultBackoffSettings());
         return decodeOperation;
     }
-    /**
-     * Resume a migration job that is currently stopped and is resumable (was
-     * stopped during CDC phase).
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.name
-     *   Name of the migration job resource to resume.
-     * @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
-     *   a long running operation. Its `promise()` method returns a promise
-     *   you can `await` for.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
-     *   for more details and examples.
-     * @example
-     * const [operation] = await client.resumeMigrationJob(request);
-     * const [response] = await operation.promise();
-     */
     resumeMigrationJob(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -797,7 +633,7 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 name: request.name || '',
             });
         this.initialize();
@@ -812,39 +648,15 @@ class DataMigrationServiceClient {
      *   Please see the
      *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
      *   for more details and examples.
-     * @example
-     * const decodedOperation = await checkResumeMigrationJobProgress(name);
-     * console.log(decodedOperation.result);
-     * console.log(decodedOperation.done);
-     * console.log(decodedOperation.metadata);
+     * @example <caption>include:samples/generated/v1/data_migration_service.resume_migration_job.js</caption>
+     * region_tag:datamigration_v1_generated_DataMigrationService_ResumeMigrationJob_async
      */
     async checkResumeMigrationJobProgress(name) {
-        const request = new google_gax_1.operationsProtos.google.longrunning.GetOperationRequest({ name });
+        const request = new this._gaxModule.operationsProtos.google.longrunning.GetOperationRequest({ name });
         const [operation] = await this.operationsClient.getOperation(request);
-        const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.resumeMigrationJob, gax.createDefaultBackoffSettings());
+        const decodeOperation = new this._gaxModule.Operation(operation, this.descriptors.longrunning.resumeMigrationJob, this._gaxModule.createDefaultBackoffSettings());
         return decodeOperation;
     }
-    /**
-     * Promote a migration job, stopping replication to the destination and
-     * promoting the destination to be a standalone database.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.name
-     *   Name of the migration job resource to promote.
-     * @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
-     *   a long running operation. Its `promise()` method returns a promise
-     *   you can `await` for.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
-     *   for more details and examples.
-     * @example
-     * const [operation] = await client.promoteMigrationJob(request);
-     * const [response] = await operation.promise();
-     */
     promoteMigrationJob(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -859,7 +671,7 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 name: request.name || '',
             });
         this.initialize();
@@ -874,39 +686,15 @@ class DataMigrationServiceClient {
      *   Please see the
      *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
      *   for more details and examples.
-     * @example
-     * const decodedOperation = await checkPromoteMigrationJobProgress(name);
-     * console.log(decodedOperation.result);
-     * console.log(decodedOperation.done);
-     * console.log(decodedOperation.metadata);
+     * @example <caption>include:samples/generated/v1/data_migration_service.promote_migration_job.js</caption>
+     * region_tag:datamigration_v1_generated_DataMigrationService_PromoteMigrationJob_async
      */
     async checkPromoteMigrationJobProgress(name) {
-        const request = new google_gax_1.operationsProtos.google.longrunning.GetOperationRequest({ name });
+        const request = new this._gaxModule.operationsProtos.google.longrunning.GetOperationRequest({ name });
         const [operation] = await this.operationsClient.getOperation(request);
-        const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.promoteMigrationJob, gax.createDefaultBackoffSettings());
+        const decodeOperation = new this._gaxModule.Operation(operation, this.descriptors.longrunning.promoteMigrationJob, this._gaxModule.createDefaultBackoffSettings());
         return decodeOperation;
     }
-    /**
-     * Verify a migration job, making sure the destination can reach the source
-     * and that all configuration and prerequisites are met.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.name
-     *   Name of the migration job resource to verify.
-     * @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
-     *   a long running operation. Its `promise()` method returns a promise
-     *   you can `await` for.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
-     *   for more details and examples.
-     * @example
-     * const [operation] = await client.verifyMigrationJob(request);
-     * const [response] = await operation.promise();
-     */
     verifyMigrationJob(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -921,7 +709,7 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 name: request.name || '',
             });
         this.initialize();
@@ -936,40 +724,15 @@ class DataMigrationServiceClient {
      *   Please see the
      *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
      *   for more details and examples.
-     * @example
-     * const decodedOperation = await checkVerifyMigrationJobProgress(name);
-     * console.log(decodedOperation.result);
-     * console.log(decodedOperation.done);
-     * console.log(decodedOperation.metadata);
+     * @example <caption>include:samples/generated/v1/data_migration_service.verify_migration_job.js</caption>
+     * region_tag:datamigration_v1_generated_DataMigrationService_VerifyMigrationJob_async
      */
     async checkVerifyMigrationJobProgress(name) {
-        const request = new google_gax_1.operationsProtos.google.longrunning.GetOperationRequest({ name });
+        const request = new this._gaxModule.operationsProtos.google.longrunning.GetOperationRequest({ name });
         const [operation] = await this.operationsClient.getOperation(request);
-        const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.verifyMigrationJob, gax.createDefaultBackoffSettings());
+        const decodeOperation = new this._gaxModule.Operation(operation, this.descriptors.longrunning.verifyMigrationJob, this._gaxModule.createDefaultBackoffSettings());
         return decodeOperation;
     }
-    /**
-     * Restart a stopped or failed migration job, resetting the destination
-     * instance to its original state and starting the migration process from
-     * scratch.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.name
-     *   Name of the migration job resource to restart.
-     * @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
-     *   a long running operation. Its `promise()` method returns a promise
-     *   you can `await` for.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
-     *   for more details and examples.
-     * @example
-     * const [operation] = await client.restartMigrationJob(request);
-     * const [response] = await operation.promise();
-     */
     restartMigrationJob(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -984,7 +747,7 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 name: request.name || '',
             });
         this.initialize();
@@ -999,50 +762,15 @@ class DataMigrationServiceClient {
      *   Please see the
      *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
      *   for more details and examples.
-     * @example
-     * const decodedOperation = await checkRestartMigrationJobProgress(name);
-     * console.log(decodedOperation.result);
-     * console.log(decodedOperation.done);
-     * console.log(decodedOperation.metadata);
+     * @example <caption>include:samples/generated/v1/data_migration_service.restart_migration_job.js</caption>
+     * region_tag:datamigration_v1_generated_DataMigrationService_RestartMigrationJob_async
      */
     async checkRestartMigrationJobProgress(name) {
-        const request = new google_gax_1.operationsProtos.google.longrunning.GetOperationRequest({ name });
+        const request = new this._gaxModule.operationsProtos.google.longrunning.GetOperationRequest({ name });
         const [operation] = await this.operationsClient.getOperation(request);
-        const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.restartMigrationJob, gax.createDefaultBackoffSettings());
+        const decodeOperation = new this._gaxModule.Operation(operation, this.descriptors.longrunning.restartMigrationJob, this._gaxModule.createDefaultBackoffSettings());
         return decodeOperation;
     }
-    /**
-     * Creates a new connection profile in a given project and location.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.parent
-     *   Required. The parent, which owns this collection of connection profiles.
-     * @param {string} request.connectionProfileId
-     *   Required. The connection profile identifier.
-     * @param {google.cloud.clouddms.v1.ConnectionProfile} request.connectionProfile
-     *   Required. The create request body including the connection profile data
-     * @param {string} request.requestId
-     *   A unique id used to identify the request. If the server receives two
-     *   requests with the same id, then the second request will be ignored.
-     *
-     *   It is recommended to always set this value to a UUID.
-     *
-     *   The id must contain only letters (a-z, A-Z), numbers (0-9), underscores
-     *   (_), and hyphens (-). The maximum length is 40 characters.
-     * @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
-     *   a long running operation. Its `promise()` method returns a promise
-     *   you can `await` for.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
-     *   for more details and examples.
-     * @example
-     * const [operation] = await client.createConnectionProfile(request);
-     * const [response] = await operation.promise();
-     */
     createConnectionProfile(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -1057,7 +785,7 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 parent: request.parent || '',
             });
         this.initialize();
@@ -1072,49 +800,15 @@ class DataMigrationServiceClient {
      *   Please see the
      *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
      *   for more details and examples.
-     * @example
-     * const decodedOperation = await checkCreateConnectionProfileProgress(name);
-     * console.log(decodedOperation.result);
-     * console.log(decodedOperation.done);
-     * console.log(decodedOperation.metadata);
+     * @example <caption>include:samples/generated/v1/data_migration_service.create_connection_profile.js</caption>
+     * region_tag:datamigration_v1_generated_DataMigrationService_CreateConnectionProfile_async
      */
     async checkCreateConnectionProfileProgress(name) {
-        const request = new google_gax_1.operationsProtos.google.longrunning.GetOperationRequest({ name });
+        const request = new this._gaxModule.operationsProtos.google.longrunning.GetOperationRequest({ name });
         const [operation] = await this.operationsClient.getOperation(request);
-        const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.createConnectionProfile, gax.createDefaultBackoffSettings());
+        const decodeOperation = new this._gaxModule.Operation(operation, this.descriptors.longrunning.createConnectionProfile, this._gaxModule.createDefaultBackoffSettings());
         return decodeOperation;
     }
-    /**
-     * Update the configuration of a single connection profile.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {google.protobuf.FieldMask} request.updateMask
-     *   Required. Field mask is used to specify the fields to be overwritten in the
-     *   connection profile resource by the update.
-     * @param {google.cloud.clouddms.v1.ConnectionProfile} request.connectionProfile
-     *   Required. The connection profile parameters to update.
-     * @param {string} request.requestId
-     *   A unique id used to identify the request. If the server receives two
-     *   requests with the same id, then the second request will be ignored.
-     *
-     *   It is recommended to always set this value to a UUID.
-     *
-     *   The id must contain only letters (a-z, A-Z), numbers (0-9), underscores
-     *   (_), and hyphens (-). The maximum length is 40 characters.
-     * @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
-     *   a long running operation. Its `promise()` method returns a promise
-     *   you can `await` for.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
-     *   for more details and examples.
-     * @example
-     * const [operation] = await client.updateConnectionProfile(request);
-     * const [response] = await operation.promise();
-     */
     updateConnectionProfile(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -1129,7 +823,7 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 'connection_profile.name': request.connectionProfile.name || '',
             });
         this.initialize();
@@ -1144,51 +838,15 @@ class DataMigrationServiceClient {
      *   Please see the
      *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
      *   for more details and examples.
-     * @example
-     * const decodedOperation = await checkUpdateConnectionProfileProgress(name);
-     * console.log(decodedOperation.result);
-     * console.log(decodedOperation.done);
-     * console.log(decodedOperation.metadata);
+     * @example <caption>include:samples/generated/v1/data_migration_service.update_connection_profile.js</caption>
+     * region_tag:datamigration_v1_generated_DataMigrationService_UpdateConnectionProfile_async
      */
     async checkUpdateConnectionProfileProgress(name) {
-        const request = new google_gax_1.operationsProtos.google.longrunning.GetOperationRequest({ name });
+        const request = new this._gaxModule.operationsProtos.google.longrunning.GetOperationRequest({ name });
         const [operation] = await this.operationsClient.getOperation(request);
-        const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.updateConnectionProfile, gax.createDefaultBackoffSettings());
+        const decodeOperation = new this._gaxModule.Operation(operation, this.descriptors.longrunning.updateConnectionProfile, this._gaxModule.createDefaultBackoffSettings());
         return decodeOperation;
     }
-    /**
-     * Deletes a single Database Migration Service connection profile.
-     * A connection profile can only be deleted if it is not in use by any
-     * active migration jobs.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.name
-     *   Required. Name of the connection profile resource to delete.
-     * @param {string} request.requestId
-     *   A unique id used to identify the request. If the server receives two
-     *   requests with the same id, then the second request will be ignored.
-     *
-     *   It is recommended to always set this value to a UUID.
-     *
-     *   The id must contain only letters (a-z, A-Z), numbers (0-9), underscores
-     *   (_), and hyphens (-). The maximum length is 40 characters.
-     * @param {boolean} request.force
-     *   In case of force delete, the CloudSQL replica database is also deleted
-     *   (only for CloudSQL connection profile).
-     * @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
-     *   a long running operation. Its `promise()` method returns a promise
-     *   you can `await` for.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
-     *   for more details and examples.
-     * @example
-     * const [operation] = await client.deleteConnectionProfile(request);
-     * const [response] = await operation.promise();
-     */
     deleteConnectionProfile(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -1203,7 +861,7 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 name: request.name || '',
             });
         this.initialize();
@@ -1218,62 +876,15 @@ class DataMigrationServiceClient {
      *   Please see the
      *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations)
      *   for more details and examples.
-     * @example
-     * const decodedOperation = await checkDeleteConnectionProfileProgress(name);
-     * console.log(decodedOperation.result);
-     * console.log(decodedOperation.done);
-     * console.log(decodedOperation.metadata);
+     * @example <caption>include:samples/generated/v1/data_migration_service.delete_connection_profile.js</caption>
+     * region_tag:datamigration_v1_generated_DataMigrationService_DeleteConnectionProfile_async
      */
     async checkDeleteConnectionProfileProgress(name) {
-        const request = new google_gax_1.operationsProtos.google.longrunning.GetOperationRequest({ name });
+        const request = new this._gaxModule.operationsProtos.google.longrunning.GetOperationRequest({ name });
         const [operation] = await this.operationsClient.getOperation(request);
-        const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.deleteConnectionProfile, gax.createDefaultBackoffSettings());
+        const decodeOperation = new this._gaxModule.Operation(operation, this.descriptors.longrunning.deleteConnectionProfile, this._gaxModule.createDefaultBackoffSettings());
         return decodeOperation;
     }
-    /**
-     * Lists migration jobs in a given project and location.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.parent
-     *   Required. The parent, which owns this collection of migrationJobs.
-     * @param {number} request.pageSize
-     *   The maximum number of migration jobs to return. The service may return
-     *   fewer than this value. If unspecified, at most 50 migration jobs will be
-     *   returned. The maximum value is 1000; values above 1000 will be coerced to
-     *   1000.
-     * @param {string} request.pageToken
-     *   The nextPageToken value received in the previous call to
-     *   migrationJobs.list, used in the subsequent request to retrieve the next
-     *   page of results. On first call this should be left blank. When paginating,
-     *   all other parameters provided to migrationJobs.list must match the call
-     *   that provided the page token.
-     * @param {string} request.filter
-     *   A filter expression that filters migration jobs listed in the response.
-     *   The expression must specify the field name, a comparison operator, and the
-     *   value that you want to use for filtering. The value must be a string,
-     *   a number, or a boolean. The comparison operator must be
-     *   either =, !=, >, or <. For example, list migration jobs created this year
-     *   by specifying **createTime %gt; 2020-01-01T00:00:00.000000000Z.**
-     *   You can also filter nested fields. For example, you could specify
-     *   **reverseSshConnectivity.vmIp = "1.2.3.4"** to select all migration
-     *   jobs connecting through the specific SSH tunnel bastion.
-     * @param {string} request.orderBy
-     *   Sort the results based on the migration job name.
-     *   Valid values are: "name", "name asc", and "name desc".
-     * @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 Array of [MigrationJob]{@link google.cloud.clouddms.v1.MigrationJob}.
-     *   The client library will perform auto-pagination by default: it will call the API as many
-     *   times as needed and will merge results from all the pages into this array.
-     *   Note that it can affect your quota.
-     *   We recommend using `listMigrationJobsAsync()`
-     *   method described below for async iteration which you can stop as needed.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
-     *   for more details and examples.
-     */
     listMigrationJobs(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -1288,7 +899,7 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 parent: request.parent || '',
             });
         this.initialize();
@@ -1342,10 +953,11 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 parent: request.parent || '',
             });
-        const callSettings = new gax.CallSettings(options);
+        const defaultCallSettings = this._defaults['listMigrationJobs'];
+        const callSettings = defaultCallSettings.merge(options);
         this.initialize();
         return this.descriptors.page.listMigrationJobs.createStream(this.innerApiCalls.listMigrationJobs, request, callSettings);
     }
@@ -1391,11 +1003,8 @@ class DataMigrationServiceClient {
      *   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.listMigrationJobsAsync(request);
-     * for await (const response of iterable) {
-     *   // process response
-     * }
+     * @example <caption>include:samples/generated/v1/data_migration_service.list_migration_jobs.js</caption>
+     * region_tag:datamigration_v1_generated_DataMigrationService_ListMigrationJobs_async
      */
     listMigrationJobsAsync(request, options) {
         request = request || {};
@@ -1403,57 +1012,14 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 parent: request.parent || '',
             });
-        options = options || {};
-        const callSettings = new gax.CallSettings(options);
+        const defaultCallSettings = this._defaults['listMigrationJobs'];
+        const callSettings = defaultCallSettings.merge(options);
         this.initialize();
         return this.descriptors.page.listMigrationJobs.asyncIterate(this.innerApiCalls['listMigrationJobs'], request, callSettings);
     }
-    /**
-     * Retrieve a list of all connection profiles in a given project and location.
-     *
-     * @param {Object} request
-     *   The request object that will be sent.
-     * @param {string} request.parent
-     *   Required. The parent, which owns this collection of connection profiles.
-     * @param {number} request.pageSize
-     *   The maximum number of connection profiles to return. The service may return
-     *   fewer than this value. If unspecified, at most 50 connection profiles will
-     *   be returned. The maximum value is 1000; values above 1000 will be coerced
-     *   to 1000.
-     * @param {string} request.pageToken
-     *   A page token, received from a previous `ListConnectionProfiles` call.
-     *   Provide this to retrieve the subsequent page.
-     *
-     *   When paginating, all other parameters provided to `ListConnectionProfiles`
-     *   must match the call that provided the page token.
-     * @param {string} request.filter
-     *   A filter expression that filters connection profiles listed in the
-     *   response. The expression must specify the field name, a comparison
-     *   operator, and the value that you want to use for filtering. The value must
-     *   be a string, a number, or a boolean. The comparison operator must be either
-     *   =, !=, >, or <. For example, list connection profiles created this year by
-     *   specifying **createTime %gt; 2020-01-01T00:00:00.000000000Z**. You can
-     *   also filter nested fields. For example, you could specify **mySql.username
-     *   = %lt;my_username%gt;** to list all connection profiles configured to
-     *   connect with a specific username.
-     * @param {string} request.orderBy
-     *   the order by fields for the result.
-     * @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 Array of [ConnectionProfile]{@link google.cloud.clouddms.v1.ConnectionProfile}.
-     *   The client library will perform auto-pagination by default: it will call the API as many
-     *   times as needed and will merge results from all the pages into this array.
-     *   Note that it can affect your quota.
-     *   We recommend using `listConnectionProfilesAsync()`
-     *   method described below for async iteration which you can stop as needed.
-     *   Please see the
-     *   [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination)
-     *   for more details and examples.
-     */
     listConnectionProfiles(request, optionsOrCallback, callback) {
         request = request || {};
         let options;
@@ -1468,7 +1034,7 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 parent: request.parent || '',
             });
         this.initialize();
@@ -1521,10 +1087,11 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 parent: request.parent || '',
             });
-        const callSettings = new gax.CallSettings(options);
+        const defaultCallSettings = this._defaults['listConnectionProfiles'];
+        const callSettings = defaultCallSettings.merge(options);
         this.initialize();
         return this.descriptors.page.listConnectionProfiles.createStream(this.innerApiCalls.listConnectionProfiles, request, callSettings);
     }
@@ -1569,11 +1136,8 @@ class DataMigrationServiceClient {
      *   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.listConnectionProfilesAsync(request);
-     * for await (const response of iterable) {
-     *   // process response
-     * }
+     * @example <caption>include:samples/generated/v1/data_migration_service.list_connection_profiles.js</caption>
+     * region_tag:datamigration_v1_generated_DataMigrationService_ListConnectionProfiles_async
      */
     listConnectionProfilesAsync(request, options) {
         request = request || {};
@@ -1581,11 +1145,11 @@ class DataMigrationServiceClient {
         options.otherArgs = options.otherArgs || {};
         options.otherArgs.headers = options.otherArgs.headers || {};
         options.otherArgs.headers['x-goog-request-params'] =
-            gax.routingHeader.fromParams({
+            this._gaxModule.routingHeader.fromParams({
                 parent: request.parent || '',
             });
-        options = options || {};
-        const callSettings = new gax.CallSettings(options);
+        const defaultCallSettings = this._defaults['listConnectionProfiles'];
+        const callSettings = defaultCallSettings.merge(options);
         this.initialize();
         return this.descriptors.page.listConnectionProfiles.asyncIterate(this.innerApiCalls['listConnectionProfiles'], request, callSettings);
     }
@@ -1746,8 +1310,7 @@ class DataMigrationServiceClient {
      * @returns {Promise} A promise that resolves when the client is closed.
      */
     close() {
-        this.initialize();
-        if (!this._terminated) {
+        if (this.dataMigrationServiceStub && !this._terminated) {
             return this.dataMigrationServiceStub.then(stub => {
                 this._terminated = true;
                 stub.close();