第 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。