第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 を参照してください。