搜索

第 2 章 使用软件开发组件

download PDF

本章定义了 Ruby 软件开发套件的模块和类,并描述了它们的用法。

2.1. 类

OvirtSDK4 模块包含以下软件开发 kit 类:

连接
Connection 类是连接到服务器的机制,并获取对服务树根目录的引用。详情请查看 第 3.1 节 “连接到 Red Hat Virtualization Manager”
类型

Type 类实施 API 支持的类型。例如,Vm 类是虚拟机类型的实施。类是数据容器,不包含任何逻辑。您将使用类型实例。

这些类的实例用作参数并返回服务方法值。到底层表示的转换由软件开发工具包透明处理。

服务

Service 类实施 API 支持的服务。例如,VmsService 类是服务实施,用于管理系统中虚拟机的集合。

当引用服务时,SDK 会自动创建这些类的实例。例如,当您调用 SystemService 类的 vms_service 方法时,SDK 会自动创建 VmsService 类的新实例:

vms_service = connection.system_service.vms_service
警告

不要手动创建这些类的实例。构造器参数和方法将来可能会改变。

Error

Error 类是软件开发工具包在报告错误时引发的基础例外类。

某些特定的错误类扩展基本错误类:

  • AuthError - 身份验证或授权失败
  • ConnectionError - 服务器名称无法解析,或者服务器无法访问
  • NotFoundError - Requested 对象不存在
  • TimeoutError - Operation time-out
其他类
其他类(如 HTTP 客户端类、读取器和作者)用于 HTTP 通信,以及用于 XML 解析和渲染。不建议使用这些类,因为它们组成将来可能会改变的内部实施详情。无法依赖于其向后兼容。
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.