Method MigrateVM

pkg/api/vm_lifecycle.go:188–277

MigrateVM migrates a VM or container to another node using the Proxmox API. The migration process supports both QEMU VMs and LXC containers with different options and behaviors: For QEMU VMs: - Online migration (live migration) is supported for running VMs - Offline migration requires the VM to be

(vm *VM, options *MigrationOptions)

//
// Returns the task UPID and an error if the migration cannot be initiated.
func (c *Client) MigrateVM(vm *VM, options *MigrationOptions) (string, error) {
	if options == nil || options.Target == "" {
		return "", fmt.Errorf("target node is required for migration")
	}

	// Validate target node exists
	if c.Cluster != nil {
		targetExists := false

		for _, node := range c.Cluster.Nodes {
			if node != nil && node.Name == options.Target {
				targetExists = true

				break
			}
		}

		if !targetExists {
			return "", fmt.Errorf("target node '%s' not found in cluster", options.Target)
		}
	}

	path := fmt.Sprintf("/nodes/%s/%s/%d/migrate", vm.Node, vm.Type, vm.ID)

	// Build migration data
	data := map[string]interface{}{
		"target": options.Target,
	}

	// Set migration parameters based on VM type
	if vm.Type == VMTypeQemu {
		// QEMU VMs use online parameter for live/offline migration
		if options.Online != nil {
			if *options.Online {
				data["online"] = "1"
			} else {
				data["online"] = "0"
			}
		} else {
			// Default: online migration for running VMs, offline for stopped VMs
			if vm.Status == VMStatusRunning {
				data["online"] = "1"
			} else {
				data["online"] = "0"
			}
		}
	} else if vm.Type == VMTypeLXC {
		// LXC containers use restart parameter (they don't support live migration)
		data["restart"] = "1"
	}

	// Add optional parameters
	if options.Force {
		data["force"] = "1"
	}

	if options.MigrationNetwork != "" {
		data["migration_network"] = options.MigrationNetwork