Oracle VM VirtualBox 4.0.32 Programming Guide and Reference

• 语言: 英语
• 格式: .pdf
• 来源: download.virtualbox.org

摘要

文档提供了Oracle VM VirtualBox 4.0.32的编程指南和参考手册，详细介绍了如何使用其API接口进行虚拟机的创建、配置和管理。主要内容包括VirtualBox的分层结构、Main API的功能、虚拟机的导入导出过程，以及与虚拟系统描述相关的属性和方法。文档还涵盖了如何通过不同语言和框架与VirtualBox进行交互，并提供了具体的编程示例。

AI总结

### Oracle VM VirtualBox 4.0.32 编程指南和参考资料总结

#### 1. 概述
- **VirtualBox 的模块化结构**：VirtualBox 分为多个层次，包括底层的虚拟化引擎（hypervisor）、内部模块（如 RDP 服务器、实时迁移模块）和 API 层。API 层（称为“主 API”）是开发者与 VirtualBox 交互的核心接口。
- **主 API**：完全文档化，支持创建、配置、启动、停止和删除虚拟机，获取性能统计信息，配置 VirtualBox 安装，以及设置虚拟系统参数。
- **WebService 和 COM/XPCOM**：VirtualBox 提供WebService（基于 JAX-WS、Python、PHP 等语言的接口）和 COM/XPCOM 接口，支持多种编程语言和环境。

#### 2. 主 API 的核心功能
- **虚拟机管理**：
- 获取虚拟机信息：读取虚拟机的属性（如 UUID、操作系统类型、硬件版本等）。
- 配置虚拟机：设置 CPU 数量、内存大小、存储设备等。
- 控制虚拟机：启动、停止、暂停和恢复虚拟机。
- **性能统计**：获取运行中虚拟机的性能数据。
- **虚拟机导出和导入**：通过 OVF（开放虚拟化格式）导出和导入虚拟机，支持 XML 描述文件（.ovf）和打包文件（.ova）。

#### 3. 编程接口（Interfaces）
- **IAppliance**：表示 OVF 格式的平台无关型设备，支持导入和导出虚拟机。
- **属性**：
- `path`：OVF 文件路径。
- `disks`：虚拟磁盘定义。
- `virtualSystemDescriptions`：虚拟系统描述。
- `machines`：导入后生成的虚拟机 UUID 数组。
- **方法**：
- `interpret()`：解析 OVF 文件。
- `importMachines()`：导入虚拟机并返回进度对象。
- `createVFSExplorer()`：创建文件系统探测器。
- **IMachine**：表示单个虚拟机，支持配置虚拟机硬件和操作系统参数。
- **属性**：
- `id`：虚拟机 UUID。
- `OSTypeId`：操作系统类型标识。
- `HardwareVersion`：硬件版本。
- `CPUCount`：虚拟 CPU 数量。
- `memorySize`：系统内存大小。
- **方法**：
- `export()`：导出虚拟机到 OVF 格式。
- `setFinalValues()`：设置导出/导入过程中的最终参数。

#### 4. 虚拟机管理示例
- **导出虚拟机**：
1. 调用 `IVirtualBox::createAppliance()` 创建空的 IAppliance 对象。
2. 调用 `IMachine::export()` 将虚拟机写入 OVF 文件。
- **导入虚拟机**：
1. 调用 `IVirtualBox::createAppliance()` 创建空的 IAppliance 对象。
2. 调用 `read()` 读取 OVF 文件。
3. 调用 `interpret()` 解析文件。
4. 调用 `importMachines()` 导入虚拟机并获取进度对象。

#### 5. 注意事项
- **编程考虑**：
- 使用主 API 可以通过多种语言（如 Java、Python、PHP 等）实现。
- OVF 文件的解析和导出/导入操作可能涉及长时间的磁盘操作。
- **版本兼容性**：文档中提到部分 API 变化可能会影响兼容性，建议在更新前检查版本说明。

总结：Oracle VM VirtualBox 4.0.32 提供了强大且灵活的编程接口，支持通过主 API 和 WebService/COM/XPCOM 实现对虚拟机的全面管理和控制，适用于虚拟化解决方案的开发。