@google-cloud/dms 1.0.5 → 2.1.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.
@@ -40,7 +40,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,11 +63,10 @@ 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}.
      */
     constructor(opts) {
         var _a, _b;
@@ -98,6 +97,10 @@ class DataMigrationServiceClient {
         this._opts = opts;
         // Save the auth object to the client, for use by other methods.
         this.auth = this._gaxGrpc.auth;
+        // Set useJWTAccessWithScope on the auth object.
+        this.auth.useJWTAccessWithScope = true;
+        // Set defaultServicePath on the auth object.
+        this.auth.defaultServicePath = staticMembers.servicePath;
         // Set the default scopes in auth client if needed.
         if (servicePath === staticMembers.servicePath) {
             this.auth.defaultScopes = staticMembers.scopes;
@@ -141,11 +144,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');
@@ -296,23 +361,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;
@@ -333,32 +381,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;
@@ -379,23 +401,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;
@@ -416,40 +421,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;
@@ -479,11 +450,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 });
@@ -491,37 +459,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;
@@ -551,11 +488,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 });
@@ -563,38 +497,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;
@@ -624,11 +526,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 });
@@ -636,26 +535,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;
@@ -685,11 +564,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 });
@@ -697,26 +573,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;
@@ -746,11 +602,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 });
@@ -758,27 +611,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;
@@ -808,11 +640,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 });
@@ -820,27 +649,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;
@@ -870,11 +678,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 });
@@ -882,27 +687,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;
@@ -932,11 +716,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 });
@@ -944,28 +725,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;
@@ -995,11 +754,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 });
@@ -1007,38 +763,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;
@@ -1068,11 +792,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 });
@@ -1080,37 +801,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;
@@ -1140,11 +830,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 });
@@ -1152,39 +839,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;
@@ -1214,11 +868,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 });
@@ -1226,50 +877,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;
@@ -1341,7 +948,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);
     }
@@ -1387,11 +995,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 || {};
@@ -1402,54 +1007,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;
@@ -1520,7 +1082,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);
     }
@@ -1565,11 +1128,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 || {};
@@ -1580,8 +1140,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);
     }
@@ -1742,11 +1302,11 @@ 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();
+                this.operationsClient.close();
             });
         }
         return Promise.resolve();