付録A ConnectionBuilder メソッド

次の表は、Java ソフトウェア開発キットの V4 で使用される ConnectionBuilder クラスで利用可能な主要なメソッドの概要を示しています。

表A.1 ConnectionBuilder メソッド

メソッド引数のタイプ説明

user

String

Manager に接続するためのユーザーの名前。admin@internal など、ユーザー名とドメインの両方を指定する必要があります。このメソッドは、password メソッドと一緒に使用する必要があります。

password

String

Manager に接続するためのユーザーのパスワード。

compress

Boolean

Manager がホストされているサーバーからのレスポンスを圧縮するかどうかを指定します。このオプションはデフォルトで無効になっているため、このメソッドはこのオプションを有効にする場合にのみ必要です。

timeout

Integer

リクエストへのレスポンスを待機するためのタイムアウト (秒単位)。リクエストのレスポンスにこの値よりも時間がかかる場合、リクエストはキャンセルされ、例外が出力されます。この引数は任意です。

ssoUrl

String

Manager がホストされているサーバーのベース URL。たとえば、パスワード認証の場合は https://server.example.com/ovirt-engine/sso/oauth/token?\grant_type=password&scope=ovirt-app-api です。

ssoRevokeUrl

String

SSO 取り消しサービスのベース URL。このオプションは、外部認証サービスを使用する場合にのみ指定する必要があります。デフォルトでは、この URL は url オプションの値から自動的に計算されるため、エンジンの一部である SSO サービスを使用して SSO トークンの取り消しが実行されます。

ssoTokenName

String

SSO サーバーから返された JSONSSO レスポンスのトークン名。デフォルトでは、この値は access_token です。

insecure

Boolean

Manager がホストされているサーバーによって提示された SSL 証明書のホスト名の検証を有効または無効にします。デフォルトでは、ホスト名の ID が検証され、ホスト名が正しくない場合は接続が拒否されるため、このメソッドはこのオプションを無効にする場合にのみ必要です。

trustStoreFile

String

Manager がホストされているサーバーによって提示された証明書を検証するために使用される CA 証明書を含むファイルの場所を指定します。このメソッドは、trustStorePassword メソッドと一緒に使用する必要があります。

trustStorePassword

String

trustStorePath メソッドで指定されたキーストアファイルにアクセスするために使用されるパスワード。