第 3 章 Ruby 示例
3.1. 连接到 Red Hat Virtualization Manager
Connection
类是软件开发工具包的入口点。它提供对 Red Hat Virtualization Manager REST API 服务的访问。
Connection
类的参数有:
-
URL
- Red Hat Virtualization Manager API 的基本 URL -
用户名
-
密码
-
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
连接以及从其获取的所有服务,无法在连接关闭后使用。
如果连接失败,软件开发工具包将引发错误异常,包含故障的详细信息。http://www.rubydoc.info/gems/ovirt-engine-sdk/OvirtSDK4/Error
如需更多信息,请参阅 http://www.rubydoc.info/gems/ovirt-engine-sdk/OvirtSDK4/Connection:initialize。