feat: add adaptation modifiers and storage pools to MigratingVM target defaults

Google APIs · copybara-github · commit aeb84bb966af · 2025-11-16T02:02:23.000-08:00
feat: add adaptation modifiers and guest OS features to ImageImport target details
docs: A comment for method `CancelImageImportJob` in service `VmMigration` is changed
docs: A comment for message `DataDiskImageImport` is changed

PiperOrigin-RevId: 832917413
diff --git a/google/cloud/vmmigration/v1/vmmigration.proto b/google/cloud/vmmigration/v1/vmmigration.proto
@@ -703,7 +703,7 @@ service VmMigration {
     option (google.api.method_signature) = "name";
   }
 
-  // Initiates the cancellation of a running clone job.
+  // Initiates the cancellation of a running ImageImportJob.
   rpc CancelImageImportJob(CancelImageImportJobRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -3023,6 +3023,11 @@ message ComputeEngineTargetDefaults {
   // convert the virtual machine from using the existing boot option to another.
   BootConversion boot_conversion = 20 [(google.api.field_behavior) = OPTIONAL];
 
+  // Optional. AdaptationModifiers are the set of modifiers used during OS
+  // adaptation.
+  repeated AdaptationModifier adaptation_modifiers = 23
+      [(google.api.field_behavior) = OPTIONAL];
+
   // Optional. Additional replica zones of the target regional disks.
   // If this list is not empty a regional disk will be created. The first
   // supported zone would be the one stated in the
@@ -3034,6 +3039,24 @@ message ComputeEngineTargetDefaults {
   // zonal disk will be created in the same zone the VM is created.
   repeated string disk_replica_zones = 24
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If specified this will be the storage pool in which the disk is
+  // created. This is the full path of the storage pool resource, for example:
+  // "projects/my-project/zones/us-central1-a/storagePools/my-storage-pool".
+  // The storage pool must be in the same project and zone as the target disks.
+  // The storage pool's type must match the disk type.
+  string storage_pool = 25 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// AdaptationModifier a modifier to be used for configuration of the OS
+// adaptation process.
+message AdaptationModifier {
+  // Optional. The modifier name.
+  string modifier = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The value of the modifier.
+  // The actual value depends on the modifier and can also be empty.
+  string value = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // ComputeEngineTargetDetails is a collection of details for creating a VM in a
@@ -3109,6 +3132,11 @@ message ComputeEngineTargetDetails {
   // convert the virtual machine from using the existing boot option to another.
   BootConversion boot_conversion = 20 [(google.api.field_behavior) = OPTIONAL];
 
+  // Optional. Modifiers to be used as configuration of the OS adaptation
+  // process.
+  repeated AdaptationModifier adaptation_modifiers = 23
+      [(google.api.field_behavior) = OPTIONAL];
+
   // Optional. Additional replica zones of the target regional disks.
   // If this list is not empty a regional disk will be created. The first
   // supported zone would be the one stated in the
@@ -3120,6 +3148,14 @@ message ComputeEngineTargetDetails {
   // zonal disk will be created in the same zone the VM is created.
   repeated string disk_replica_zones = 24
       [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The storage pool used for the VM disks.
+  // If specified this will be the storage pool in which the disk is created.
+  // This is the full path of the storage pool resource, for example:
+  // "projects/my-project/zones/us-central1-a/storagePools/my-storage-pool".
+  // The storage pool must be in the same project and zone as the target disks.
+  // The storage pool's type must match the disk type.
+  string storage_pool = 25 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // NetworkInterface represents a NIC of a VM.
@@ -4844,10 +4880,28 @@ message ImageImportOsAdaptationParameters {
   // image from using the existing boot option to another.
   // The size of the boot disk might be increased to allow the conversion
   BootConversion boot_conversion = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Modifiers to be used as configuration of the OS adaptation
+  // process.
+  repeated AdaptationModifier adaptation_modifiers = 4
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
-// Mentions that the image import is not using OS adaptation process.
-message DataDiskImageImport {}
+// Used when the image import is not using OS adaptation process.
+message DataDiskImageImport {
+  // Optional. A list of guest OS features to apply to the imported image. These
+  // features are flags that are used by Compute Engine to enable certain
+  // capabilities for virtual machine instances that are created from the image.
+  //
+  // This field does not change the OS of the image; it only marks the image
+  // with the specified features. The user must ensure that the OS is
+  // compatible with the features.
+  //
+  // For a list of available features, see
+  // https://cloud.google.com/compute/docs/images/create-custom#guest-os-features.
+  repeated string guest_os_features = 1
+      [(google.api.field_behavior) = OPTIONAL];
+}
 
 // Mentions that the machine image import is not using OS adaptation process.
 message SkipOsAdaptation {}
