2.2. サーバーへの接続

サーバーに接続するには、Connection クラスを含む ovirtsdk4 モジュールをインポートします。これは SDK のエントリーポイントであり、API のサービスツリーのルートへのアクセスを提供します。

import ovirtsdk4 as sdk

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

この接続には、サーバーへの HTTP 接続のプールや認証トークンなどの重要なリソースが含まれています。これらのリソースが使用されなくなったら、これらのリソースを解放することが非常に重要です。

connection.close()

接続が閉じられると、再利用できなくなります。

TLS で保護されたサーバーに接続する場合は、ca.pem ファイルが必要です。通常のインストールでは、Manager マシンの /etc/pki/ovirt-engine/ にあります。ca_file を指定しない場合、システム全体の CA 証明書ストアが使用されます。ca.pem ファイルの取得の詳細は、REST API ガイド を参照してください。

正常に接続されない場合には、SDK で、詳細を含む ovirtsdk4.Error の例外が発生します。