feat(vmmigration)!: update the API

BREAKING CHANGE: This release has breaking changes. #### vmmigration:v1alpha1 The following keys were deleted: - schemas.CycleStep.description - schemas.CycleStep.id - schemas.CycleStep.properties.endTime.description - schemas.CycleStep.properties.endTime.format - schemas.CycleStep.properties.endTime.type - schemas.CycleStep.properties.initializingReplication.$ref - schemas.CycleStep.properties.initializingReplication.description - schemas.CycleStep.properties.postProcessing.$ref - schemas.CycleStep.properties.postProcessing.description - schemas.CycleStep.properties.replicating.$ref - schemas.CycleStep.properties.replicating.description - schemas.CycleStep.properties.startTime.description - schemas.CycleStep.properties.startTime.format - schemas.CycleStep.properties.startTime.type - schemas.CycleStep.type - schemas.FetchInventoryResponse.properties.vmwareVms.readOnly - schemas.InitializingReplicationStep.description - schemas.InitializingReplicationStep.id - schemas.InitializingReplicationStep.type - schemas.PostProcessingStep.description - schemas.PostProcessingStep.id - schemas.PostProcessingStep.type - schemas.ReplicatingStep.description - schemas.ReplicatingStep.id - schemas.ReplicatingStep.properties.lastThirtyMinutesAverageBytesPerSecond.description - schemas.ReplicatingStep.properties.lastThirtyMinutesAverageBytesPerSecond.format - schemas.ReplicatingStep.properties.lastThirtyMinutesAverageBytesPerSecond.type - schemas.ReplicatingStep.properties.lastTwoMinutesAverageBytesPerSecond.description - schemas.ReplicatingStep.properties.lastTwoMinutesAverageBytesPerSecond.format - schemas.ReplicatingStep.properties.lastTwoMinutesAverageBytesPerSecond.type - schemas.ReplicatingStep.properties.replicatedBytes.description - schemas.ReplicatingStep.properties.replicatedBytes.format - schemas.ReplicatingStep.properties.replicatedBytes.type - schemas.ReplicatingStep.properties.totalBytes.description - schemas.ReplicatingStep.properties.totalBytes.format - schemas.ReplicatingStep.properties.totalBytes.type - schemas.ReplicatingStep.type - schemas.ReplicationCycle.properties.endTime.description - schemas.ReplicationCycle.properties.endTime.format - schemas.ReplicationCycle.properties.endTime.type - schemas.ReplicationCycle.properties.steps.description - schemas.ReplicationCycle.properties.steps.items.$ref - schemas.ReplicationCycle.properties.steps.type The following keys were added: - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.description - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.flatPath - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.httpMethod - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.id - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.parameterOrder - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.parameters.datacenterConnector.description - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.parameters.datacenterConnector.location - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.parameters.datacenterConnector.pattern - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.parameters.datacenterConnector.required - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.parameters.datacenterConnector.type - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.path - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.request.$ref - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.response.$ref - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.scopes - schemas.ApplianceVersion.description - schemas.ApplianceVersion.id - schemas.ApplianceVersion.properties.critical.description - schemas.ApplianceVersion.properties.critical.type - schemas.ApplianceVersion.properties.releaseNotesUri.description - schemas.ApplianceVersion.properties.releaseNotesUri.type - schemas.ApplianceVersion.properties.uri.description - schemas.ApplianceVersion.properties.uri.type - schemas.ApplianceVersion.properties.version.description - schemas.ApplianceVersion.properties.version.type - schemas.ApplianceVersion.type - schemas.AvailableUpdates.description - schemas.AvailableUpdates.id - schemas.AvailableUpdates.properties.inPlaceUpdate.$ref - schemas.AvailableUpdates.properties.inPlaceUpdate.description - schemas.AvailableUpdates.properties.newDeployableAppliance.$ref - schemas.AvailableUpdates.properties.newDeployableAppliance.description - schemas.AvailableUpdates.type - schemas.CloneJob.properties.name.readOnly - schemas.DatacenterConnector.properties.applianceInfrastructureVersion.description - schemas.DatacenterConnector.properties.applianceInfrastructureVersion.readOnly - schemas.DatacenterConnector.properties.applianceInfrastructureVersion.type - schemas.DatacenterConnector.properties.applianceSoftwareVersion.description - schemas.DatacenterConnector.properties.applianceSoftwareVersion.readOnly - schemas.DatacenterConnector.properties.applianceSoftwareVersion.type - schemas.DatacenterConnector.properties.availableVersions.$ref - schemas.DatacenterConnector.properties.availableVersions.description - schemas.DatacenterConnector.properties.availableVersions.readOnly - schemas.DatacenterConnector.properties.upgradeStatus.$ref - schemas.DatacenterConnector.properties.upgradeStatus.description - schemas.DatacenterConnector.properties.upgradeStatus.readOnly - schemas.Group.properties.name.readOnly - schemas.TargetProject.properties.name.readOnly - schemas.UpgradeApplianceRequest.description - schemas.UpgradeApplianceRequest.id - schemas.UpgradeApplianceRequest.properties.requestId.description - schemas.UpgradeApplianceRequest.properties.requestId.type - schemas.UpgradeApplianceRequest.type - schemas.UpgradeStatus.description - schemas.UpgradeStatus.id - schemas.UpgradeStatus.properties.error.$ref - schemas.UpgradeStatus.properties.error.description - schemas.UpgradeStatus.properties.previousVersion.description - schemas.UpgradeStatus.properties.previousVersion.type - schemas.UpgradeStatus.properties.startTime.description - schemas.UpgradeStatus.properties.startTime.format - schemas.UpgradeStatus.properties.startTime.type - schemas.UpgradeStatus.properties.state.description - schemas.UpgradeStatus.properties.state.enum - schemas.UpgradeStatus.properties.state.enumDescriptions - schemas.UpgradeStatus.properties.state.type - schemas.UpgradeStatus.properties.version.description - schemas.UpgradeStatus.properties.version.type - schemas.UpgradeStatus.type The following keys were changed: - resources.projects.resources.locations.resources.groups.methods.patch.parameters.name.description - resources.projects.resources.locations.resources.targetProjects.methods.patch.parameters.name.description - schemas.CloneJob.properties.name.description - schemas.FetchInventoryResponse.properties.vmwareVms.description - schemas.Group.properties.name.description - schemas.TargetProject.properties.name.description - schemas.VmwareVmDetails.properties.guestDescription.description #### vmmigration:v1 The following keys were deleted: - schemas.FetchInventoryResponse.properties.vmwareVms.readOnly The following keys were added: - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.description - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.flatPath - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.httpMethod - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.id - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.parameterOrder - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.parameters.datacenterConnector.description - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.parameters.datacenterConnector.location - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.parameters.datacenterConnector.pattern - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.parameters.datacenterConnector.required - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.parameters.datacenterConnector.type - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.path - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.request.$ref - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.response.$ref - resources.projects.resources.locations.resources.sources.resources.datacenterConnectors.methods.upgradeAppliance.scopes - schemas.ApplianceVersion.description - schemas.ApplianceVersion.id - schemas.ApplianceVersion.properties.critical.description - schemas.ApplianceVersion.properties.critical.type - schemas.ApplianceVersion.properties.releaseNotesUri.description - schemas.ApplianceVersion.properties.releaseNotesUri.type - schemas.ApplianceVersion.properties.uri.description - schemas.ApplianceVersion.properties.uri.type - schemas.ApplianceVersion.properties.version.description - schemas.ApplianceVersion.properties.version.type - schemas.ApplianceVersion.type - schemas.AvailableUpdates.description - schemas.AvailableUpdates.id - schemas.AvailableUpdates.properties.inPlaceUpdate.$ref - schemas.AvailableUpdates.properties.inPlaceUpdate.description - schemas.AvailableUpdates.properties.newDeployableAppliance.$ref - schemas.AvailableUpdates.properties.newDeployableAppliance.description - schemas.AvailableUpdates.type - schemas.CloneJob.properties.name.readOnly - schemas.DatacenterConnector.properties.applianceInfrastructureVersion.description - schemas.DatacenterConnector.properties.applianceInfrastructureVersion.readOnly - schemas.DatacenterConnector.properties.applianceInfrastructureVersion.type - schemas.DatacenterConnector.properties.applianceSoftwareVersion.description - schemas.DatacenterConnector.properties.applianceSoftwareVersion.readOnly - schemas.DatacenterConnector.properties.applianceSoftwareVersion.type - schemas.DatacenterConnector.properties.availableVersions.$ref - schemas.DatacenterConnector.properties.availableVersions.description - schemas.DatacenterConnector.properties.availableVersions.readOnly - schemas.DatacenterConnector.properties.upgradeStatus.$ref - schemas.DatacenterConnector.properties.upgradeStatus.description - schemas.DatacenterConnector.properties.upgradeStatus.readOnly - schemas.Group.properties.name.readOnly - schemas.TargetProject.properties.name.readOnly - schemas.UpgradeApplianceRequest.description - schemas.UpgradeApplianceRequest.id - schemas.UpgradeApplianceRequest.properties.requestId.description - schemas.UpgradeApplianceRequest.properties.requestId.type - schemas.UpgradeApplianceRequest.type - schemas.UpgradeStatus.description - schemas.UpgradeStatus.id - schemas.UpgradeStatus.properties.error.$ref - schemas.UpgradeStatus.properties.error.description - schemas.UpgradeStatus.properties.previousVersion.description - schemas.UpgradeStatus.properties.previousVersion.type - schemas.UpgradeStatus.properties.startTime.description - schemas.UpgradeStatus.properties.startTime.format - schemas.UpgradeStatus.properties.startTime.type - schemas.UpgradeStatus.properties.state.description - schemas.UpgradeStatus.properties.state.enum - schemas.UpgradeStatus.properties.state.enumDescriptions - schemas.UpgradeStatus.properties.state.type - schemas.UpgradeStatus.properties.version.description - schemas.UpgradeStatus.properties.version.type - schemas.UpgradeStatus.type The following keys were changed: - resources.projects.resources.locations.resources.groups.methods.patch.parameters.name.description - resources.projects.resources.locations.resources.targetProjects.methods.patch.parameters.name.description - schemas.CloneJob.properties.name.description - schemas.FetchInventoryResponse.properties.vmwareVms.description - schemas.Group.properties.name.description - schemas.TargetProject.properties.name.description - schemas.VmwareVmDetails.properties.guestDescription.description
googleapis · Mar 8, 2022 · 8f0c650 · 8f0c650
1 parent 762c73d
commit 8f0c650
Show file tree

Hide file tree

Showing 4 changed files with 807 additions and 173 deletions.
diff --git a/discovery/vmmigration-v1.json b/discovery/vmmigration-v1.json
@@ -356,7 +356,7 @@
                   ],
                   "parameters": {
                     "name": {
-                      "description": "The Group name.",
+                      "description": "Output only. The Group name.",
                       "location": "path",
                       "pattern": "^projects/[^/]+/locations/[^/]+/groups/[^/]+$",
                       "required": true,
@@ -890,6 +890,34 @@
                       "scopes": [
                         "https://www.googleapis.com/auth/cloud-platform"
                       ]
+                    },
+                    "upgradeAppliance": {
+                      "description": "Upgrades the appliance relate to this DatacenterConnector to the in-place updateable version.",
+                      "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/sources/{sourcesId}/datacenterConnectors/{datacenterConnectorsId}:upgradeAppliance",
+                      "httpMethod": "POST",
+                      "id": "vmmigration.projects.locations.sources.datacenterConnectors.upgradeAppliance",
+                      "parameterOrder": [
+                        "datacenterConnector"
+                      ],
+                      "parameters": {
+                        "datacenterConnector": {
+                          "description": "Required. The DatacenterConnector name.",
+                          "location": "path",
+                          "pattern": "^projects/[^/]+/locations/[^/]+/sources/[^/]+/datacenterConnectors/[^/]+$",
+                          "required": true,
+                          "type": "string"
+                        }
+                      },
+                      "path": "v1/{+datacenterConnector}:upgradeAppliance",
+                      "request": {
+                        "$ref": "UpgradeApplianceRequest"
+                      },
+                      "response": {
+                        "$ref": "Operation"
+                      },
+                      "scopes": [
+                        "https://www.googleapis.com/auth/cloud-platform"
+                      ]
                     }
                   }
                 },
@@ -1822,7 +1850,7 @@
                   ],
                   "parameters": {
                     "name": {
-                      "description": "The name of the target project.",
+                      "description": "Output only. The name of the target project.",
                       "location": "path",
                       "pattern": "^projects/[^/]+/locations/[^/]+/targetProjects/[^/]+$",
                       "required": true,
@@ -1858,7 +1886,7 @@
       }
     }
   },
-  "revision": "20220120",
+  "revision": "20220225",
   "rootUrl": "https://vmmigration.googleapis.com/",
   "schemas": {
     "AddGroupMigrationRequest": {
@@ -1872,6 +1900,29 @@
       },
       "type": "object"
     },
+    "ApplianceVersion": {
+      "description": "Describes an appliance version.",
+      "id": "ApplianceVersion",
+      "properties": {
+        "critical": {
+          "description": "Determine whether it's critical to upgrade the appliance to this version.",
+          "type": "boolean"
+        },
+        "releaseNotesUri": {
+          "description": "Link to a page that contains the version release notes.",
+          "type": "string"
+        },
+        "uri": {
+          "description": "A link for downloading the version.",
+          "type": "string"
+        },
+        "version": {
+          "description": "The appliance version.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "AppliedLicense": {
       "description": "AppliedLicense holds the license data returned by adaptation module report.",
       "id": "AppliedLicense",
@@ -1899,6 +1950,21 @@
       },
       "type": "object"
     },
+    "AvailableUpdates": {
+      "description": "Holds informatiom about the available versions for upgrade.",
+      "id": "AvailableUpdates",
+      "properties": {
+        "inPlaceUpdate": {
+          "$ref": "ApplianceVersion",
+          "description": "The latest version for in place update. The current appliance can be updated to this version using the API or m4c CLI."
+        },
+        "newDeployableAppliance": {
+          "$ref": "ApplianceVersion",
+          "description": "The newest deployable version of the appliance. The current appliance can't be updated into this version, and the owner must manually deploy this OVA to a new appliance."
+        }
+      },
+      "type": "object"
+    },
     "CancelCloneJobRequest": {
       "description": "Request message for 'CancelCloneJob' request.",
       "id": "CancelCloneJobRequest",
@@ -1938,7 +2004,8 @@
           "readOnly": true
         },
         "name": {
-          "description": "The name of the clone.",
+          "description": "Output only. The name of the clone.",
+          "readOnly": true,
           "type": "string"
         },
         "state": {
@@ -2342,6 +2409,21 @@
       "description": "DatacenterConnector message describes a connector between the Source and GCP, which is installed on a vmware datacenter (an OVA vm installed by the user) to connect the Datacenter to GCP and support vm migration data transfer.",
       "id": "DatacenterConnector",
       "properties": {
+        "applianceInfrastructureVersion": {
+          "description": "Output only. Appliance OVA version. This is the OVA which is manually installed by the user and contains the infrastructure for the automatically updatable components on the appliance.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "applianceSoftwareVersion": {
+          "description": "Output only. Appliance last installed update bundle version. This is the version of the automatically updatable components on the appliance.",
+          "readOnly": true,
+          "type": "string"
+        },
+        "availableVersions": {
+          "$ref": "AvailableUpdates",
+          "description": "Output only. The available versions for updating this appliance.",
+          "readOnly": true
+        },
         "bucket": {
           "description": "Output only. The communication channel between the datacenter connector and GCP.",
           "readOnly": true,
@@ -2402,6 +2484,11 @@
           "readOnly": true,
           "type": "string"
         },
+        "upgradeStatus": {
+          "$ref": "UpgradeStatus",
+          "description": "Output only. The status of the current / last upgradeAppliance operation.",
+          "readOnly": true
+        },
         "version": {
           "description": "The version running in the DatacenterConnector. This is supplied by the OVA connector during the registration process and can not be modified.",
           "type": "string"
@@ -2427,8 +2514,7 @@
         },
         "vmwareVms": {
           "$ref": "VmwareVmsDetails",
-          "description": "Output only. The description of the VMs in a Source of type Vmware.",
-          "readOnly": true
+          "description": "The description of the VMs in a Source of type Vmware."
         }
       },
       "type": "object"
@@ -2458,7 +2544,8 @@
           "type": "string"
         },
         "name": {
-          "description": "The Group name.",
+          "description": "Output only. The Group name.",
+          "readOnly": true,
           "type": "string"
         },
         "updateTime": {
@@ -3269,7 +3356,8 @@
           "type": "string"
         },
         "name": {
-          "description": "The name of the target project.",
+          "description": "Output only. The name of the target project.",
+          "readOnly": true,
           "type": "string"
         },
         "project": {
@@ -3285,6 +3373,57 @@
       },
       "type": "object"
     },
+    "UpgradeApplianceRequest": {
+      "description": "Request message for 'UpgradeAppliance' request.",
+      "id": "UpgradeApplianceRequest",
+      "properties": {
+        "requestId": {
+          "description": "A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and t he request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "UpgradeStatus": {
+      "description": "UpgradeStatus contains information about upgradeAppliance operation.",
+      "id": "UpgradeStatus",
+      "properties": {
+        "error": {
+          "$ref": "Status",
+          "description": "Provides details on the state of the upgrade operation in case of an error."
+        },
+        "previousVersion": {
+          "description": "The version from which we upgraded.",
+          "type": "string"
+        },
+        "startTime": {
+          "description": "The time the operation was started.",
+          "format": "google-datetime",
+          "type": "string"
+        },
+        "state": {
+          "description": "The state of the upgradeAppliance operation.",
+          "enum": [
+            "STATE_UNSPECIFIED",
+            "RUNNING",
+            "FAILED",
+            "SUCCEEDED"
+          ],
+          "enumDescriptions": [
+            "The state was not sampled by the health checks yet.",
+            "The upgrade has started.",
+            "The upgrade failed.",
+            "The upgrade finished successfully."
+          ],
+          "type": "string"
+        },
+        "version": {
+          "description": "The version to upgrade to.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "UtilizationReport": {
       "description": "Utilization report details the utilization (CPU, memory, etc.) of selected source VMs.",
       "id": "UtilizationReport",
@@ -3506,7 +3645,7 @@
           "type": "string"
         },
         "guestDescription": {
-          "description": "The VM's OS. See for example https://pubs.vmware.com/vi-sdk/visdk250/ReferenceGuide/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html for types of strings this might hold.",
+          "description": "The VM's OS. See for example https://vdc-repo.vmware.com/vmwb-repository/dcr-public/da47f910-60ac-438b-8b9b-6122f4d14524/16b7274a-bf8b-4b4c-a05e-746f2aa93c8c/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html for types of strings this might hold.",
           "type": "string"
         },
         "memoryMb": {