付録B ConnectionBuilder メソッド

以下の表では、Java ソフトウェア開発キット V4 で使用する ConnectionBuilder クラスで利用可能な主要メソッドについて説明します。

表B.1 ConnectionBuilder メソッド

メソッド引数タイプ説明
user文字列Manager への接続に使用するユーザー。admin@internal のようにユーザー名とドメインの両方を指定する必要があります。このメソッドは、password メソッドと合わせて使用する必要があります。
password文字列Manager への接続に使用するユーザーのパスワード。
compressブール値Manager をホストしているサーバーからの応答を圧縮するべきかどうかを指定します。デフォルトでは、このオプションは無効になっているため、このオプションを有効にする場合のみにこのメソッドは必要です。
timeout整数要求に応答するまで待機するタイムアウトの値 (秒)。要求への応答時間がこの値よりも長い場合には、要求はキャンセルされ、例外が送出されます。この引数は任意です。
ssoUrl文字列Manager をホストするサーバーのベース URL。たとえば、パスワード認証には https://server.example.com/ovirt-engine/sso/oauth/token?\grant_type=password&scope=ovirt-app-api を使用します。
ssoRevokeUrl文字列SSO 呼び出しサービスのベース URL。外部認証サービスを使用する場合にのみこのオプションを指定する必要があります。デフォルトでは、engine の一部となっている SSO サービスを使用して SSO トークンの呼び出しが実行されるように、この URL は自動的に url オプションの値から算出されます。
ssoTokenName文字列SSO サーバーから返される JSON SSO の応答にあるトークン名。デフォルトでは、この値は access_token です。
insecureブール値Manager のホスト先のサーバーが公開する SSL 証明書のホスト名の検証を有効化または無効化します。デフォルトでは、ホスト名のアイデンティティーは検証され、ホスト名が正しくない場合には接続が拒否されます。そのため、このオプションを無効にする場合のみこのメソッドが必要です。
trustStoreFile文字列Manager のホスト先のサーバーが公開する証明書の検証に使用する CA 証明書が含まれるファイルの場所を指定します。このメソッドは、trustStorePassword メソッドと合わせて使用する必要があります。
trustStorePassword文字列trustStorePath メソッドで指定するキーストアファイルにアクセスする際に使用するパスワード。