第4章 クイックスタートの例
このセクションの例では、REST API を使用して基本的な Red Hat Virtualization 環境を設定し、仮想マシンを作成する方法を説明します。これらの例では、標準の前提条件に加えて、以下が必要です。
- ネットワーク接続され、設定済みの Red Hat Virtualization ホスト。
- インストールする仮想マシンのオペレーティングシステムを含む ISO ファイル。この章では、インストール ISO のサンプルとして CentOS 7 を使用します。
API の例では、curl を使用してクライアントアプリケーションでの API 要求を紹介します。HTTP 要求を送信するアプリケーションを使用できます。
この例の HTTP 要求ヘッダーでは、Host と Authorization ヘッダーが省略されています。ただし、これらのフィールドは必須であり、Red Hat Virtualization のインストールに固有のデータを必要とします。
curl の例では、ユーザー名に admin@internal、パスワードに mypassword、証明書の場所には /etc/pki/ovirt-engine/ca.pem、ホスト名に myengine.example.com を使用します。ご使用の環境の正しい値に置き換える必要があります。
Red Hat Virtualization は、リソースごとに id 属性の一意の ID を生成します。これらの例の識別子コードは、お使いの Red Hat Virtualization 環境の識別子コードとは異なります。
多くの例では、API によって返される結果の属性の一部が省略され、簡潔さが保たれます。属性の完全なリストは、クラスター reference を参照してください。
4.1. API エントリーポイントへのアクセス
以下の要求は、API のバージョン 4 のメインエントリーポイントの表現を取得します。
GET /ovirt-engine/api HTTP/1.1 Version: 4 Accept: application/xml
同じリクエストですが、Version ヘッダーの代わりに /v4 URL 接頭辞を使用します。
GET /ovirt-engine/api/v4 HTTP/1.1 Accept: application/xml
curl コマンドを使用した同じ要求。
curl \ --cacert '/etc/pki/ovirt-engine/ca.pem' \ --request GET \ --header 'Version: 4' \ --header 'Accept: application/xml' \ --user 'admin@internal:mypassword' \ https://myengine.example.com/ovirt-engine/api
結果は、Api タイプのオブジェクトです。
<api>
<link href="/ovirt-engine/api/clusters" rel="clusters"/>
<link href="/ovirt-engine/api/datacenters" rel="datacenters"/>
...
<product_info>
<name>oVirt Engine</name>
<vendor>ovirt.org</vendor>
<version>
<build>0</build>
<full_version>4.0.0-0.0.el7</full_version>
<major>4</major>
<minor>0</minor>
<revision>0</revision>
</version>
</product_info>
<special_objects>
<blank_template href="..." id="..."/>
<root_tag href="..." id="..."/>
</special_objects>
<summary>
<hosts>
<active>23</active>
<total>30</total>
</hosts>
<storage_domains>
<active>5</active>
<total>6</total>
</storage_domains>
<users>
<active>12</active>
<total>102</total>
</users>
<vms>
<active>253</active>
<total>545</total>
</vms>
</summary>
<time>2016-10-06T15:38:18.548+02:00</time>
</api>
ヘッダーと URL 接頭辞が使用されていない場合には、サーバーは自動的にバージョンを選択します。デフォルトはバージョン 4 です。ENGINE_API_DEFAULT_VERSION 設定パラメーターを使用してデフォルトのバージョンを変更できます。
# echo "ENGINE_API_DEFAULT_VERSION=3" > \ /etc/ovirt-engine/engine.conf.d/99-set-default-version.conf # systemctl restart ovirt-engine
このパラメーターを変更すると、バージョンを明示的に指定しない API のすべてのユーザーに影響があります。
エントリーポイントは、仮想化環境のコレクションへのリンクをユーザーに提供します。各コレクションリンクの rel 属性は、各リンクの参照ポイントを提供します。この例の次のステップは、データセンターコレクションを検証し、これは datacenters リンクから入手できます。
エントリーポイントには、product_info、special_objects、summary などの他のデータも含まれます。このデータは、この例以外の章で説明しています。
