Libvirt Python API的blockCopy报错：缺少设备源信息

问题根源 #

virsh命令里的vda是磁盘设备别名，virsh会自动查询目标域的设备信息，补全源磁盘的完整XML描述后调用底层libvirt接口；但Python API的blockCopy方法不会自动做这个映射，必须显式传入源磁盘的完整XML，而非简单的设备别名或路径。

正确实现步骤 #

1. 从目标域中获取源磁盘（vda）的完整XML描述
2. 调整目标磁盘的XML格式，确保标签合规
3. 设置对应flags，匹配virsh命令中的--wait和--pivot参数

修正后的代码示例 #

import libvirt

# 连接libvirt服务
conn = libvirt.open()
domain = conn.lookupByName('mydomain')

# 获取源磁盘vda的完整XML描述
source_xml = domain.deviceXMLByName('vda')

# 目标磁盘XML：用<source>指定文件路径，<target>保持设备名与源一致
dest_xml = """
<disk>
    <source file='/my_new_path/disk.qcow2'/>
    <format type='qcow2'/>
    <target dev='vda'/>
</disk>
"""

# 对应virsh --wait和--pivot参数的flags
flags = libvirt.VIR_DOMAIN_BLOCK_COPY_FLAG_WAIT | libvirt.VIR_DOMAIN_BLOCK_COPY_FLAG_PIVOT

try:
    domain.blockCopy(source_xml, dest_xml, {}, flags)
    print("活跃磁盘迁移完成")
except libvirt.libvirtError as e:
    print(f"执行错误: {e}")
finally:
    conn.close()

关键说明 #

• 源参数source_xml必须包含源磁盘的所有必要信息（如源文件路径、格式、设备类型等），通过domain.deviceXMLByName()可直接获取符合要求的XML
• 目标XML中，<source>标签用于指定目标文件路径，<target>标签需和源设备的dev名称保持一致（此处为vda），确保迁移后设备映射正确
• flags参数组合了等待复制完成和自动切换磁盘的功能，与virsh命令中的--wait --pivot效果完全一致

内容的提问来源于stack exchange，提问作者PatrickF