@google-cloud/dms 3.0.0 → 3.2.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [3.2.0](https://github.com/googleapis/google-cloud-node/compare/dms-v3.1.0...dms-v3.2.0) (2024-02-09)
+
+
+### Features
+
+* Support for Trusted Private Cloud ([895830a](https://github.com/googleapis/google-cloud-node/commit/895830a3ef91666c30a96a7f68bd4cd1f582d58d))
+
+## [3.1.0](https://github.com/googleapis/google-cloud-node/compare/dms-v3.0.0...dms-v3.1.0) (2023-09-06)
+
+
+### Features
+
+* [clouddms] Adding GenerateTcpProxyScript API ([#4610](https://github.com/googleapis/google-cloud-node/issues/4610)) ([1a79bf7](https://github.com/googleapis/google-cloud-node/commit/1a79bf704f9cae5b58df19778f52496aeaf9bc06))
+
+
+### Bug Fixes
+
+* [Many APIs] simplify logic for HTTP/1.1 REST fallback option ([#4584](https://github.com/googleapis/google-cloud-node/issues/4584)) ([13537fc](https://github.com/googleapis/google-cloud-node/commit/13537fcd6e3c552199d5057daf3b00c24033c908))
+
 ## [3.0.0](https://github.com/googleapis/google-cloud-node/compare/dms-v2.3.0...dms-v3.0.0) (2023-08-06)
 
 

package/README.md

@@ -88,23 +88,28 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Data_migration_service.convert_conversion_workspace | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.convert_conversion_workspace.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.convert_conversion_workspace.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.create_connection_profile | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.create_connection_profile.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.create_connection_profile.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.create_conversion_workspace | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.create_conversion_workspace.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.create_conversion_workspace.js,packages/google-cloud-clouddms/samples/README.md) |
+| Data_migration_service.create_mapping_rule | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.create_mapping_rule.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.create_mapping_rule.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.create_migration_job | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.create_migration_job.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.create_migration_job.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.create_private_connection | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.create_private_connection.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.create_private_connection.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.delete_connection_profile | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.delete_connection_profile.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.delete_connection_profile.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.delete_conversion_workspace | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.delete_conversion_workspace.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.delete_conversion_workspace.js,packages/google-cloud-clouddms/samples/README.md) |
+| Data_migration_service.delete_mapping_rule | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.delete_mapping_rule.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.delete_mapping_rule.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.delete_migration_job | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.delete_migration_job.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.delete_migration_job.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.delete_private_connection | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.delete_private_connection.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.delete_private_connection.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.describe_conversion_workspace_revisions | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.describe_conversion_workspace_revisions.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.describe_conversion_workspace_revisions.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.describe_database_entities | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.describe_database_entities.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.describe_database_entities.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.fetch_static_ips | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.fetch_static_ips.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.fetch_static_ips.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.generate_ssh_script | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.generate_ssh_script.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.generate_ssh_script.js,packages/google-cloud-clouddms/samples/README.md) |
+| Data_migration_service.generate_tcp_proxy_script | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.generate_tcp_proxy_script.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.generate_tcp_proxy_script.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.get_connection_profile | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.get_connection_profile.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.get_connection_profile.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.get_conversion_workspace | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.get_conversion_workspace.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.get_conversion_workspace.js,packages/google-cloud-clouddms/samples/README.md) |
+| Data_migration_service.get_mapping_rule | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.get_mapping_rule.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.get_mapping_rule.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.get_migration_job | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.get_migration_job.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.get_migration_job.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.get_private_connection | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.get_private_connection.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.get_private_connection.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.import_mapping_rules | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.import_mapping_rules.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.import_mapping_rules.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.list_connection_profiles | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.list_connection_profiles.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.list_connection_profiles.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.list_conversion_workspaces | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.list_conversion_workspaces.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.list_conversion_workspaces.js,packages/google-cloud-clouddms/samples/README.md) |
+| Data_migration_service.list_mapping_rules | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.list_mapping_rules.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.list_mapping_rules.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.list_migration_jobs | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.list_migration_jobs.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.list_migration_jobs.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.list_private_connections | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.list_private_connections.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.list_private_connections.js,packages/google-cloud-clouddms/samples/README.md) |
 | Data_migration_service.promote_migration_job | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.promote_migration_job.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-cloud-clouddms/samples/generated/v1/data_migration_service.promote_migration_job.js,packages/google-cloud-clouddms/samples/README.md) |
@@ -128,7 +133,7 @@ also contains samples.
 
 ## Supported Node.js Versions
 
-Our client libraries follow the [Node.js release schedule](https://nodejs.org/en/about/releases/).
+Our client libraries follow the [Node.js release schedule](https://github.com/nodejs/release#release-schedule).
 Libraries are compatible with all current _active_ and _maintenance_ versions of
 Node.js.
 If you are using an end-of-life version of Node.js, we recommend that you update

package/build/protos/google/cloud/clouddms/v1/clouddms.proto

@@ -23,6 +23,7 @@ import "google/api/resource.proto";
 import "google/cloud/clouddms/v1/clouddms_resources.proto";
 import "google/cloud/clouddms/v1/conversionworkspace_resources.proto";
 import "google/longrunning/operations.proto";
+import "google/protobuf/empty.proto";
 import "google/protobuf/field_mask.proto";
 import "google/protobuf/timestamp.proto";
 
@@ -191,6 +192,16 @@ service DataMigrationService {
     };
   }
 
+  // Generate a TCP Proxy configuration script to configure a cloud-hosted VM
+  // running a TCP Proxy.
+  rpc GenerateTcpProxyScript(GenerateTcpProxyScriptRequest)
+      returns (TcpProxyScript) {
+    option (google.api.http) = {
+      post: "/v1/{migration_job=projects/*/locations/*/migrationJobs/*}:generateTcpProxyScript"
+      body: "*"
+    };
+  }
+
   // Retrieves a list of all connection profiles in a given project and
   // location.
   rpc ListConnectionProfiles(ListConnectionProfilesRequest)
@@ -360,6 +371,42 @@ service DataMigrationService {
     };
   }
 
+  // Creates a new mapping rule for a given conversion workspace.
+  rpc CreateMappingRule(CreateMappingRuleRequest) returns (MappingRule) {
+    option (google.api.http) = {
+      post: "/v1/{parent=projects/*/locations/*/conversionWorkspaces/*}/mappingRules"
+      body: "mapping_rule"
+    };
+    option (google.api.method_signature) =
+        "parent,mapping_rule,mapping_rule_id";
+  }
+
+  // Deletes a single mapping rule.
+  rpc DeleteMappingRule(DeleteMappingRuleRequest)
+      returns (google.protobuf.Empty) {
+    option (google.api.http) = {
+      delete: "/v1/{name=projects/*/locations/*/conversionWorkspaces/*/mappingRules/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Lists the mapping rules for a specific conversion workspace.
+  rpc ListMappingRules(ListMappingRulesRequest)
+      returns (ListMappingRulesResponse) {
+    option (google.api.http) = {
+      get: "/v1/{parent=projects/*/locations/*/conversionWorkspaces/*}/mappingRules"
+    };
+    option (google.api.method_signature) = "parent";
+  }
+
+  // Gets the details of a mapping rule.
+  rpc GetMappingRule(GetMappingRuleRequest) returns (MappingRule) {
+    option (google.api.http) = {
+      get: "/v1/{name=projects/*/locations/*/conversionWorkspaces/*/mappingRules/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
   // Imports a snapshot of the source database into the
   // conversion workspace.
   rpc SeedConversionWorkspace(SeedConversionWorkspaceRequest)
@@ -568,14 +615,14 @@ message CreateMigrationJobRequest {
   // object.
   MigrationJob migration_job = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // A unique ID used to identify the request. If the server receives two
-  // requests with the same ID, then the second request is ignored.
+  // Optional. A unique ID used to identify the request. If the server receives
+  // two requests with the same ID, then the second request is 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.
-  string request_id = 4;
+  string request_id = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for 'UpdateMigrationJob' request.
@@ -629,6 +676,10 @@ message StartMigrationJobRequest {
   string name = 1 [(google.api.resource_reference) = {
     type: "datamigration.googleapis.com/MigrationJob"
   }];
+
+  // Optional. Start the migration job without running prior configuration
+  // verification. Defaults to `false`.
+  bool skip_validation = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for 'StopMigrationJob' request.
@@ -661,6 +712,15 @@ message VerifyMigrationJobRequest {
   string name = 1 [(google.api.resource_reference) = {
     type: "datamigration.googleapis.com/MigrationJob"
   }];
+
+  // Optional. Field mask is used to specify the changed fields to be verified.
+  // It will not update the migration job.
+  google.protobuf.FieldMask update_mask = 2
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The changed migration job parameters to verify.
+  // It will not update the migration job.
+  MigrationJob migration_job = 3 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for 'RestartMigrationJob' request.
@@ -669,6 +729,10 @@ message RestartMigrationJobRequest {
   string name = 1 [(google.api.resource_reference) = {
     type: "datamigration.googleapis.com/MigrationJob"
   }];
+
+  // Optional. Restart the migration job without running prior configuration
+  // verification. Defaults to `false`.
+  bool skip_validation = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for 'GenerateSshScript' request.
@@ -718,6 +782,38 @@ message SshScript {
   string script = 1;
 }
 
+// Request message for 'GenerateTcpProxyScript' request.
+message GenerateTcpProxyScriptRequest {
+  // Name of the migration job resource to generate the TCP Proxy script.
+  string migration_job = 1 [(google.api.resource_reference) = {
+    type: "datamigration.googleapis.com/MigrationJob"
+  }];
+
+  // Required. The name of the Compute instance that will host the proxy.
+  string vm_name = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. The type of the Compute instance that will host the proxy.
+  string vm_machine_type = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The Google Cloud Platform zone to create the VM in. The fully
+  // qualified name of the zone must be specified, including the region name,
+  // for example "us-central1-b". If not specified, uses the "-b" zone of the
+  // destination Connection Profile's region.
+  string vm_zone = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. The name of the subnet the Compute instance will use for private
+  // connectivity. Must be supplied in the form of
+  // projects/{project}/regions/{region}/subnetworks/{subnetwork}.
+  // Note: the region for the subnet must match the Compute instance region.
+  string vm_subnet = 5 [(google.api.field_behavior) = REQUIRED];
+}
+
+// Response message for 'GenerateTcpProxyScript' request.
+message TcpProxyScript {
+  // The TCP Proxy configuration script.
+  string script = 1;
+}
+
 // Request message for 'ListConnectionProfiles' request.
 message ListConnectionProfilesRequest {
   // Required. The parent which owns this collection of connection profiles.
@@ -786,7 +882,7 @@ message CreateConnectionProfileRequest {
   string parent = 1 [
     (google.api.field_behavior) = REQUIRED,
     (google.api.resource_reference) = {
-      type: "datamigration.googleapis.com/ConnectionProfile"
+      child_type: "datamigration.googleapis.com/ConnectionProfile"
     }
   ];
 
@@ -1137,6 +1233,10 @@ message DeleteConversionWorkspaceRequest {
   // The ID must contain only letters (a-z, A-Z), numbers (0-9), underscores
   // (_), and hyphens (-). The maximum length is 40 characters.
   string request_id = 2;
+
+  // Force delete the conversion workspace, even if there's a running migration
+  // that is using the workspace.
+  bool force = 3;
 }
 
 // Request message for 'CommitConversionWorkspace' request.
@@ -1180,13 +1280,74 @@ message ApplyConversionWorkspaceRequest {
   // the entities. Supports Google AIP 160 based filtering.
   string filter = 2;
 
+  // Optional. Only validates the apply process, but doesn't change the
+  // destination database. Only works for PostgreSQL destination connection
+  // profile.
+  bool dry_run = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Specifies whether the conversion workspace is to be committed
+  // automatically after the apply.
+  bool auto_commit = 4 [(google.api.field_behavior) = OPTIONAL];
+
   // Which destination to use when applying the conversion workspace.
   oneof destination {
-    // Fully qualified (Uri) name of the destination connection profile.
-    string connection_profile = 100;
+    // Optional. Fully qualified (Uri) name of the destination connection
+    // profile.
+    string connection_profile = 100 [(google.api.field_behavior) = OPTIONAL];
   }
 }
 
+// Retrieve a list of all mapping rules in a given conversion workspace.
+message ListMappingRulesRequest {
+  // Required. Name of the conversion workspace resource whose mapping rules are
+  // listed in the form of:
+  // projects/{project}/locations/{location}/conversionWorkspaces/{conversion_workspace}.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "datamigration.googleapis.com/ConversionWorkspace"
+    }
+  ];
+
+  // The maximum number of rules to return. The service may return
+  // fewer than this value.
+  int32 page_size = 2;
+
+  // The nextPageToken value received in the previous call to
+  // mappingRules.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 mappingRules.list must match the call
+  // that provided the page token.
+  string page_token = 3;
+}
+
+// Response message for 'ListMappingRulesRequest' request.
+message ListMappingRulesResponse {
+  // The list of conversion workspace mapping rules.
+  repeated MappingRule mapping_rules = 1;
+
+  // A token which can be sent as `page_token` to retrieve the next page.
+  // If this field is omitted, there are no subsequent pages.
+  string next_page_token = 2;
+}
+
+// Request message for 'GetMappingRule' request.
+message GetMappingRuleRequest {
+  // Required. Name of the mapping rule resource to get.
+  // Example: conversionWorkspaces/123/mappingRules/rule123
+  //
+  // In order to retrieve a previous revision of the mapping rule, also provide
+  // the revision ID.
+  // Example:
+  // conversionWorkspace/123/mappingRules/rule123@c7cfa2a8c7cfa2a8c7cfa2a8c7cfa2a8
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "datamigration.googleapis.com/MappingRule"
+    }
+  ];
+}
+
 // Request message for 'SeedConversionWorkspace' request.
 message SeedConversionWorkspaceRequest {
   // Name of the conversion workspace resource to seed with new database
@@ -1204,11 +1365,14 @@ message SeedConversionWorkspaceRequest {
   // either be from the source or destination databases and it can be provided
   // through a connection profile or a DDL file.
   oneof seed_from {
-    // Fully qualified (Uri) name of the source connection profile.
-    string source_connection_profile = 100;
-
-    // Fully qualified (Uri) name of the destination connection profile.
-    string destination_connection_profile = 101;
+    // Optional. Fully qualified (Uri) name of the source connection profile.
+    string source_connection_profile = 100
+        [(google.api.field_behavior) = OPTIONAL];
+
+    // Optional. Fully qualified (Uri) name of the destination connection
+    // profile.
+    string destination_connection_profile = 101
+        [(google.api.field_behavior) = OPTIONAL];
   }
 }
 
@@ -1220,26 +1384,31 @@ message ConvertConversionWorkspaceRequest {
     type: "datamigration.googleapis.com/ConversionWorkspace"
   }];
 
-  // Specifies whether the conversion workspace is to be committed automatically
-  // after the conversion.
-  bool auto_commit = 4;
+  // Optional. Specifies whether the conversion workspace is to be committed
+  // automatically after the conversion.
+  bool auto_commit = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Filter the entities to convert. Leaving this field empty will
+  // convert all of the entities. Supports Google AIP-160 style filtering.
+  string filter = 5 [(google.api.field_behavior) = OPTIONAL];
 
-  // Filter the entities to convert. Leaving this field empty will convert all
-  // of the entities. Supports Google AIP-160 style filtering.
-  string filter = 5;
+  // Optional. Automatically convert the full entity path for each entity
+  // specified by the filter. For example, if the filter specifies a table, that
+  // table schema (and database if there is one) will also be converted.
+  bool convert_full_path = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Request message for 'ImportMappingRules' request.
 message ImportMappingRulesRequest {
   // Details of a single rules file.
   message RulesFile {
-    // The filename of the rules that needs to be converted. The filename is
-    // used mainly so that future logs of the import rules job contain it, and
-    // can therefore be searched by it.
-    string rules_source_filename = 1;
+    // Required. The filename of the rules that needs to be converted. The
+    // filename is used mainly so that future logs of the import rules job
+    // contain it, and can therefore be searched by it.
+    string rules_source_filename = 1 [(google.api.field_behavior) = REQUIRED];
 
-    // The text content of the rules that needs to be converted.
-    string rules_content = 2;
+    // Required. The text content of the rules that needs to be converted.
+    string rules_content = 2 [(google.api.field_behavior) = REQUIRED];
   }
 
   // Required. Name of the conversion workspace resource to import the rules to
@@ -1252,15 +1421,16 @@ message ImportMappingRulesRequest {
     }
   ];
 
-  // The format of the rules content file.
-  ImportRulesFileFormat rules_format = 2;
+  // Required. The format of the rules content file.
+  ImportRulesFileFormat rules_format = 2
+      [(google.api.field_behavior) = REQUIRED];
 
-  // One or more rules files.
-  repeated RulesFile rules_files = 3;
+  // Required. One or more rules files.
+  repeated RulesFile rules_files = 3 [(google.api.field_behavior) = REQUIRED];
 
-  // Should the conversion workspace be committed automatically after the
-  // import operation.
-  bool auto_commit = 6;
+  // Required. Should the conversion workspace be committed automatically after
+  // the import operation.
+  bool auto_commit = 6 [(google.api.field_behavior) = REQUIRED];
 }
 
 // Request message for 'DescribeDatabaseEntities' request.
@@ -1290,31 +1460,35 @@ message DescribeDatabaseEntitiesRequest {
     }
   ];
 
-  // The maximum number of entities to return. The service may return
+  // Optional. The maximum number of entities to return. The service may return
   // fewer entities than the value specifies.
-  int32 page_size = 3;
+  int32 page_size = 3 [(google.api.field_behavior) = OPTIONAL];
 
-  // The nextPageToken value received in the previous call to
+  // Optional. The nextPageToken value received in the previous call to
   // conversionWorkspace.describeDatabaseEntities, 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
   // conversionWorkspace.describeDatabaseEntities must match the call that
   // provided the page token.
-  string page_token = 4;
+  string page_token = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Required. The tree to fetch.
+  DBTreeType tree = 6 [(google.api.field_behavior) = REQUIRED];
 
-  // The tree to fetch.
-  DBTreeType tree = 6;
+  // Optional. Whether to retrieve the latest committed version of the entities
+  // or the latest version. This field is ignored if a specific commit_id is
+  // specified.
+  bool uncommitted = 11 [(google.api.field_behavior) = OPTIONAL];
 
-  // Whether to retrieve the latest committed version of the entities or the
-  // latest version. This field is ignored if a specific commit_id is specified.
-  bool uncommitted = 11;
+  // Optional. Request a specific commit ID. If not specified, the entities from
+  // the latest commit are returned.
+  string commit_id = 12 [(google.api.field_behavior) = OPTIONAL];
 
-  // Request a specific commit ID. If not specified, the entities from the
-  // latest commit are returned.
-  string commit_id = 12;
+  // Optional. Filter the returned entities based on AIP-160 standard.
+  string filter = 13 [(google.api.field_behavior) = OPTIONAL];
 
-  // Filter the returned entities based on AIP-160 standard.
-  string filter = 13;
+  // Optional. Results view based on AIP-157
+  DatabaseEntityView view = 14 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Response message for 'DescribeDatabaseEntities' request.
@@ -1383,6 +1557,54 @@ message DescribeConversionWorkspaceRevisionsResponse {
   repeated ConversionWorkspace revisions = 1;
 }
 
+// Request message for 'CreateMappingRule' command.
+message CreateMappingRuleRequest {
+  // Required. The parent which owns this collection of mapping rules.
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "datamigration.googleapis.com/MappingRule"
+    }
+  ];
+
+  // Required. The ID of the rule to create.
+  string mapping_rule_id = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Required. Represents a [mapping rule]
+  // (https://cloud.google.com/database-migration/reference/rest/v1/projects.locations.mappingRules)
+  // object.
+  MappingRule mapping_rule = 3 [(google.api.field_behavior) = REQUIRED];
+
+  // A unique ID used to identify the request. If the server receives two
+  // requests with the same ID, then the second request is 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.
+  string request_id = 4;
+}
+
+// Request message for 'DeleteMappingRule' request.
+message DeleteMappingRuleRequest {
+  // Required. Name of the mapping rule resource to delete.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "datamigration.googleapis.com/MappingRule"
+    }
+  ];
+
+  // Optional. A unique ID used to identify the request. If the server receives
+  // two requests with the same ID, then the second request is 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.
+  string request_id = 2 [(google.api.field_behavior) = OPTIONAL];
+}
+
 // Request message for 'FetchStaticIps' request.
 message FetchStaticIpsRequest {
   // Required. The resource name for the location for which static IPs should be
@@ -1410,3 +1632,22 @@ message FetchStaticIpsResponse {
   // If this field is omitted, there are no subsequent pages.
   string next_page_token = 2;
 }
+
+// AIP-157 Partial Response view for Database Entity.
+enum DatabaseEntityView {
+  // Unspecified view. Defaults to basic view.
+  DATABASE_ENTITY_VIEW_UNSPECIFIED = 0;
+
+  // Default view. Does not return DDLs or Issues.
+  DATABASE_ENTITY_VIEW_BASIC = 1;
+
+  // Return full entity details including mappings, ddl and issues.
+  DATABASE_ENTITY_VIEW_FULL = 2;
+
+  // Top-most (Database, Schema) nodes which are returned contains summary
+  // details for their decendents such as the number of entities per type and
+  // issues rollups. When this view is used, only a single page of result is
+  // returned and the page_size property of the request is ignored. The
+  // returned page will only include the top-most node types.
+  DATABASE_ENTITY_VIEW_ROOT_SUMMARY = 3;
+}