第 3 章 Ruby 示例

3.1. 连接到 Red Hat Virtualization Manager

Connection 类是软件开发工具包的入口点。它提供对 Red Hat Virtualization Manager 的 REST API 的服务的访问权限。

Connection 类的参数有：

  • URL - Red Hat Virtualization Manager API 的基本 URL
  • username
  • password
  • ca_file - 包含可信 CA 证书的 PEM 文件。当连接到由 TLS 保护的服务器时，需要 ca.pem 文件。如果没有指定 ca_file，则使用系统范围的 CA 证书存储。

连接到 Red Hat Virtualization Manager

connection = OvirtSDK4::Connection.new(
  url: 'https://engine.example.com/ovirt-engine/api',
  username: 'admin@internal',
  password: '...',
  ca_file: 'ca.pem',
)

重要

连接保存关键资源，包括与服务器的 HTTP 连接和身份验证令牌等。当这些资源不再使用时，您必须释放这些资源： 

connection.close

连接以及从中获取的所有服务在连接关闭后无法使用。

如果连接失败，软件开发套件将引发错误 异常，包含失败的详细信息。

如需更多信息，请参阅 Connection:initialize。