3.3. 例: ホストクラスターコレクションの一覧表示

Red Hat Enterprise Virtualization Manage は、インストール時に Default のホストクラスターを作成します。以下の例は Default クラスターを使用して Red Hat Enterprise Virtualization 環境内のリソースをグループ化します。
以下の要求は、クラスターコレクションの表現を取得します。

例3.3 ホストクラスターコレクションの一覧表示

要求:

GET /api/clusters HTTP/1.1
Accept: application/xml

cURL コマンド:

# curl -X GET -H "Accept: application/xml" -u [USER:PASS] \
    --cacert [CERT] \
    https://[RHEVM Host]:443/api/clusters

結果:

HTTP/1.1 200 OK
Content-Type: application/xml

<clusters>
    <cluster id="99408929-82cf-4dc7-a532-9d998063fa95"
      href="/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95">
        <name>Default</name>
        <description>The default server cluster</description>
        <link rel="networks"
          href="/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/networks"/>
        <link rel="permissions"
          href="/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/permissions"/>
        <cpu id="Intel Penryn Family"/>
        <data_center id="01a45ff0-915a-11e0-8b87-5254004ac988"
          href="/api/datacenters/01a45ff0-915a-11e0-8b87-5254004ac988"/>
        <memory_policy>
            <overcommit percent="100"/>
            <transparent_hugepages>
                <enabled>false</enabled>
            </transparent_hugepages>
        </memory_policy>
        <scheduling_policy/>
        <version minor="0" major="3"/>
        <error_handling>
            <on_error>migrate</on_error>
        </error_handling>
    </cluster>
</clusters>

Default ホストクラスターの id コードに注意してください。このコードは、仮想化環境のその他のリソースに関連付けて、このホストクラスターを特定します。
Default クラスターは、data_center 要素の id 属性と href 属性を使用したリレーションシップにより Default データセンターに関連付けられます。
networks のサブコレクションには、このクラスターの関連付けられたネットワークリソース一覧が含まれます。次のセクションでは networks のコレクションについて詳細に考察します。