手順2.1 Java ソフトウェア開発キットのインストール

1. Red Hat Subscription Manager でお使いのシステムが Red Hat Enterprise Virtualization のエンタイトルメントにサブスクライブされていることを確認してください。

   # subscription-manager list --available | grep -A8 "Red Hat Enterprise Virtualization"
   # subscription-manager attach --pool=pool_id
   # subscription-manager repos --enable=rhel-6-server-rpms
   # subscription-manager repos --enable=rhel-6-server-rhevm-3.6-rpms
   # subscription-manager repos --enable=jb-eap-6-for-rhel-6-server-rpms

2. 必要なパッケージをインストールします。

   # yum install rhevm-sdk-java
   # yum install rhevm-sdk-java-javadoc

手順2.2 SSL の設定

1. Red Hat Enterprise Virtualization Manager 用の証明書をダウンロードします。

   https://[your manager's address]:[port]/ca.crt

2. キーストアを生成します。

   keytool -import -alias "server.crt truststore" -file ca.crt -keystore server.truststore

3. 以下のいずれかの方法で Java ソフトウェア開発キットにキーストアを認識させます。
   • キーストアのルックアップパスを作成します。

     $ mkdir ~/.ovirtsdk/
     $ cp server.truststore ~/.ovirtsdk/ovirtsdk-keystore.truststore

     ovirtsdk-keystore.truststore が ~/.ovirtsdk ディレクトリーにコピーされると、通信先のホストとのハンドシェイクでホストのアイデンティティー検証に使用されるようになります。
   • Api クラスのインスタンスを宣言する際にカスタムのトラストストアを指定するには、以下の署名を使用します。

     Api api = new Api(url, user, password, "/path/server.truststore");

手順3.1 エンティティーの一覧表示

• 一覧表示するエンティティーのタイプの List を宣言し、対応するメソッドを使用してエンティティーを一覧表示します。

  List<VM> vms = api.getVMs().list();

手順3.2 リソースの属性の変更

1. 属性を変更するリソースのインスタンスを宣言します。

   VM vm = api.getVMs().get("test");

2. 新しい属性値を設定します。

   vm.setDescription("java_sdk");

3. 変更を適用する仮想マシンを更新します。

   VM newVM = vm.update();

手順3.3 リソースに対するアクションの実行

1. リソースのインスタンスを宣言します。

    VM vm = api.getVMs().get("test");

2. リソースに送るアクションパラメーターを宣言します。

   Action actionParam = new Action();
   org.ovirt.engine.sdk.entities.VM vmParam = new org.ovirt.engine.sdk.entities.VM();
   actionParam.setVm(vmParam);

3. アクションを実行します。

   Action res = vm.start(actionParam);

手順3.4 サブリソースの一覧表示

1. 一覧表示するサブリソースが含まれているリソースのインスタンスを宣言します。

   VM vm = api.getVMs().get("test");

2. サブリソースを一覧表示します。

   List<VMDisk> disks = vm.getDisks().list();

手順3.5 リソースのサブリソースの取得

1. 参照するサブリソースが含まれているリソースのインスタンスを宣言します。

   VM vm = api.getVMs().get("test");

2. 参照するサブリソースのインスタンスを宣言します。

   VMDisk disk = vm.getDisks().get("my disk");

手順3.6 リソースへのサブソースの追加

1. サブリソースを追加するリソースのインスタンスを宣言します。

   VM vm = api.getVMs().get("test");

2. そのリソースの属性を定義するパラメーターを作成します。

   Disk diskParam = new Disk();
   diskParam.setProvisionedSize(1073741824L);
   diskParam.setInterface("virtio");
   diskParam.setFormat("cow");

3. サブリソースを追加します。

   Disk disk = vm.getDisks().add(diskParam);

手順3.7 サブリソースの更新

1. 変更するサブリソースが含まれているリソースのインスタンスを宣言します。

   VM vm = api.getVMs().get("test");

2. 変更するサブリソースのインスタンスを宣言します。

   VMDisk disk = vm.getDisks().get("test_Disk1");

3. 新しい属性値を設定します。

   disk.setAlias("test_Disk1_updated");

4. サブリソースを更新します。

   VMDisk updateDisk = disk.update();

手順3.8 サブリソースに対するアクションの実行

1. アクションを実行する対象となるサブリソースが含まれているリソースのインスタンスを宣言します。

   VM vm = api.getVMs().get("test");

2. サブリソースのインスタンスを宣言します。

   VMDisk disk = vm.getDisks().get("test_Disk1");

3. サブリソースに送信するアクションパラメーターを宣言します。

   Action actionParam = new Action();

4. アクションを実行します。

   Action result = disk.activate(actionParam);