@google-cloud/dms 1.1.0 → 2.0.0

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.
@@ -300,23 +300,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;
@@ -337,32 +320,6 @@ class DataMigrationServiceClient {
         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;
@@ -383,23 +340,6 @@ class DataMigrationServiceClient {
         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;
@@ -420,40 +360,6 @@ class DataMigrationServiceClient {
         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;
@@ -483,11 +389,8 @@ 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 });
@@ -495,37 +398,6 @@ class DataMigrationServiceClient {
         const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.createMigrationJob, gax.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;
@@ -555,11 +427,8 @@ 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 });
@@ -567,38 +436,6 @@ class DataMigrationServiceClient {
         const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.updateMigrationJob, gax.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;
@@ -628,11 +465,8 @@ 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 });
@@ -640,26 +474,6 @@ class DataMigrationServiceClient {
         const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.deleteMigrationJob, gax.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;
@@ -689,11 +503,8 @@ 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 });
@@ -701,26 +512,6 @@ class DataMigrationServiceClient {
         const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.startMigrationJob, gax.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;
@@ -750,11 +541,8 @@ 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 });
@@ -762,27 +550,6 @@ class DataMigrationServiceClient {
         const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.stopMigrationJob, gax.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;
@@ -812,11 +579,8 @@ 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 });
@@ -824,27 +588,6 @@ class DataMigrationServiceClient {
         const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.resumeMigrationJob, gax.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;
@@ -874,11 +617,8 @@ 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 });
@@ -886,27 +626,6 @@ class DataMigrationServiceClient {
         const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.promoteMigrationJob, gax.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;
@@ -936,11 +655,8 @@ 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 });
@@ -948,28 +664,6 @@ class DataMigrationServiceClient {
         const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.verifyMigrationJob, gax.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;
@@ -999,11 +693,8 @@ 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 });
@@ -1011,38 +702,6 @@ class DataMigrationServiceClient {
         const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.restartMigrationJob, gax.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;
@@ -1072,11 +731,8 @@ 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 });
@@ -1084,37 +740,6 @@ class DataMigrationServiceClient {
         const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.createConnectionProfile, gax.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;
@@ -1144,11 +769,8 @@ 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 });
@@ -1156,39 +778,6 @@ class DataMigrationServiceClient {
         const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.updateConnectionProfile, gax.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;
@@ -1218,11 +807,8 @@ 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 });
@@ -1230,50 +816,6 @@ class DataMigrationServiceClient {
         const decodeOperation = new gax.Operation(operation, this.descriptors.longrunning.deleteConnectionProfile, gax.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;
@@ -1345,7 +887,8 @@ class DataMigrationServiceClient {
             gax.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 +934,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 || {};
@@ -1406,54 +946,11 @@ class DataMigrationServiceClient {
             gax.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;
@@ -1524,7 +1021,8 @@ class DataMigrationServiceClient {
             gax.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 +1067,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 || {};
@@ -1584,8 +1079,8 @@ class DataMigrationServiceClient {
             gax.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 +1241,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();