3.3. 例：ホストクラスターの一覧表示

Red Hat Virtualization は、インストール時に Default ホストクラスターを作成します。この例では、Default クラスターを使用して Red Hat Virtualization 環境のリソースをグループ化します。

以下の要求は、クラスターコレクションの表現を取得します。

GET /ovirt-engine/api/clusters 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/clusters

結果として、Cluster タイプのオブジェクトの一覧が表示されます。

<clusters>
  <cluster href="/ovirt-engine/api/clusters/002" id="002">
    <name>Default</name>
    <description>The default server cluster</description>
    <link href="/ovirt-engine/api/clusters/002/networks" rel="networks"/>
    <link href="/ovirt-engine/api/clusters/002" rel="permissions"/>
    ...
    <cpu>
      <architecture>x86_64</architecture>
      <type>Intel Conroe Family</type>
    </cpu>
    <version>
      <major>4</major>
      <minor>0</minor>
    </version>
    <data_center href="/ovirt-engine/api/datacenters/001" id="001"/>
  </cluster>
  ...
</clusters>

Default ホストのクラスターの ID をメモします。仮想環境の他のリソースと照合して、このホストクラスターを特定します。

Default クラスターは、data_center リンクの id および href 属性を使用する関係により Default データセンターに関連付けられます。

<data_center href="/ovirt-engine/api/datacenters/001" id="001"/>

networks リンクは、このクラスターに関連付けられたネットワークを管理する サービス への参照です。次のセクションでは、ネットワークコレクションの詳細を説明します。