10.7. サブコレクション
10.7.1. Networks サブコレクション
10.7.1.1. Networks サブコレクション
クラスターに関連付けられたネットワークは、network サブ
コレクション で表されます。クラスター内のすべてのホストは、これらの関連付けられたネットワークに接続されます。
クラスターの
ネットワーク サブコレクションの表現は、以下の追加要素を除き、標準の ネットワーク リソースと同じです。
| 要素 | タイプ | 説明 | プロパティー |
|---|---|---|---|
Cluster id= | 関係 | このネットワークがメンバーになっているクラスターへの参照。 | 
|
必須 | ブール値 | 必須または任意のネットワークステータスを定義します。 | |
display | ブール値 | ディスプレイネットワークのステータスを定義します。後方互換性に使用されます。 | |
usages | complex | ネットワークの 使用 要素のセットを定義します。ユーザーは、このレベルでネットワークを VM および DISPLAY ネットワークとして定義できます。 |
API ユーザーは、標準の REST メソッドで
ネットワーク サブコレクションを操作します。ネットワーク ID またはネットワーク サブ コレクションへの 名前 参照の POSTを作成すると、ネットワークがクラスターに関連付けられます。例10.6 ネットワークリソースのクラスターとの関連付け
POST /ovirt-engine/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/networks HTTP/1.1
Accept: application/xml
Content-Type: application/xml
<network id="da05ac09-00be-45a1-b0b5-4a6a2438665f">
<name>ovirtmgmt</name>
</network>
HTTP/1.1 201 Created
Location: http://{host}/clusters/99408929-82cf-4dc7-a532-9d998063fa95/networks/da05ac09-00be-45a1-b0b5-4a6a2438665f
Content-Type: application/xml
<network id="da05ac09-00be-45a1-b0b5-4a6a2438665f"
href="/ovirt-engine/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/networks/
da05ac09-00be-45a1-b0b5-4a6a2438665f">
<name>ovirtmgmt</name>
<status>
<state>operational</state>
</status>
<description>Display Network</description>
<cluster id="99408929-82cf-4dc7-a532-9d998063fa95"
href="/ovirt-engine/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95"/>
<data_center id="d70d5e2d-b8ad-494a-a4d2-c7a5631073c4"
href="/ovirt-engine/api/datacenters/d70d5e2d-b8ad-494a-a4d2-c7a5631073c4"/>
<required>true</required>
<usages>
<usage>VM</usage>
</usages>
</network>
PUT 要求でリソースを更新します。
例10.7 ディスプレイネットワークステータスの設定
PUT /ovirt-engine/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/networks/da05ac09-00be-45a1-b0b5-4a6a2438665f HTTP/1.1
Accept: application/xml
Content-Type: application/xml
<network>
<required>false</required>
<usages>
<usage>VM</usage>
<usage>DISPLAY</usage>
</usages>
</network>
必須またはオプションのネットワークステータスは、
必要 な要素のブール値(true または false)を指定する PUT 要求を使用して設定されます。
例10.8 オプションのネットワークステータスの設定
PUT /ovirt-engine/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/networks/da05ac09-00be-45a1-b0b5-4a6a2438665f HTTP/1.1
Accept: application/xml
Content-Type: application/xml
<network>
<required>false</required>
</network>
関連付けは、コレクション内の適切な要素への
DELETE 要求で削除されます。
例10.9 クラスターからのネットワーク関連付けの削除
DELETE /ovirt-engine/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/networks/da05ac09-00be-45a1-b0b5-4a6a2438665f HTTP/1.1 HTTP/1.1 204 No Content
