libvirt对象



libvirt的对象向外展现了虚拟化环境的所有资源。libvirt API编程操纵的第一个对象总是virConnectPtr,它提供了到一个Hypervisor的连接。任何一个libvirt应用程序,都是从调用 virConnectOpen函数开始的,该函数的参数包含一个Hypervisor的URI,函数执行成功表示已连接到指定的Hypervisor,并返回一个代表该连接的virConnectPtr对象,通过这个对象,应用程序就可以管理它上面的域以及其它虚拟化资源。libvirt主要通过5个对象展现它的所有功能,对象之间的结构如图所示:



libvirt <wbr>API的基本概念



除了virConnectPtr对象外,virDomainPtr对象代表Hypervisor上的一个域;virNetworkPtr对象代表Hypervisor上的一个网络;virStorageVolPtr对象代表一个存储卷,它是可以供域使用的块存储设备;virStoragePoolPtr对象代表Hypervisor上的一个存储池,它为存储卷提供一个逻辑存储区域。



 



上述对象都有以下几种命名方法:



1)name,用户友好型的标识名,但不能保证名称在节点之间保持唯一性。



2)ID, 运行时的标识名,一般为一数字,由Hypervisor为当前活动对象指定的名称,只在对象存活期内有效。



3)UUID,一个16字节的唯一标识名,遵循RFC4122规范,可以确保名称在跨节点范围内的唯一性,并且能被长时间保持。



 



函数命名规范



libvirt库中的函数名称存在一些命名规则,主要有以下几种:



1)查找对象:[...LookupBy...]



根据对象的名称标识查找对象,如:



virDomainLookupByID 
    
 
    

          virDomainLookupByName 
    
 
    

          virDomainLookupByUUID 
    
 
    

          virDomainLookupByUUIDString



2)枚举对象数量 [virConnectList..., virConnectNumOf...]



枚举当前连接可用对象的数量,如:



   

virConnectListDomains 
    
 
    

          virConnectNumOfDomains 
    
 
    

          virConnectListNetworks 
    
 
    

          virConnectListStoragePools


3)获取对象信息 [...GetInfo]



提供对象的基本信息,如:



 

virNodeGetInfo 
    
 
    

          virDomainGetInfo 
    
 
    

          virStoragePoolGetInfo 
    
 
    

          virStorageVolGetInfo


4)访问对象 [...Get..., ...Set...]



查询或修改指定对象的数据,如:



virConnectGetType 
    
 
    

          virDomainGetMaxMemory 
    
 
    

          virDomainSetMemory 
    
 
    

          virDomainGetVcpus 
    
 
    

          virStoragePoolSetAutostart 
    
 
    

          virNetworkGetBridgeName


5)建立对象 [...Create, ...CreateXML]



建立并启动对象,可以通过XML描述信息建立对象,也可以通过对象指针建立对象,如:



   

virDomainCreate 
    
 
    

          virDomainCreateXML 
    
 
    

          virNetworkCreate 
    
 
    

          virNetworkCreateXML


6)停用对象 [...Destroy]


通过关闭、停止操作使对象失效,如:



virDomainDestroy 
    
 
    

          virNetworkDestroy 
    
 
    

          virStoragePoolDestroy



注意:有些函数返回一个对象vir*Ptr (如virDomainLookup) ,返回对象内存空间的释放需要调用对应的vir*Free函数(如virDomainFree释放一个virDomainPtr对象)。