9.5.2. ネットワークサブコレクション
9.5.2.1. Networks サブコレクション
データセンターに関連付けられたネットワークは、
ネットワーク サブコレクションで表されます。データセンターの ネットワーク サブコレクションの表現には、以下の要素が含まれます。
| 要素 | タイプ | 説明 |
|---|---|---|
name | string | ネットワークのプレーンテキストで人間が読める形式の名前。 |
description | string | ネットワークのプレーンテキストで人間が読める形式の説明。 |
rel="permissions" | 関係 | ネットワークの パーミッション サブコレクションへのリンク。 |
rel="vnicprofiles" | 関係 | ネットワークの vnicprofiles サブコレクションへのリンク。 |
rel="labels" | 関係 | ネットワークの ラベル サブコレクションへのリンク。 |
data_center id= | 関係 | ネットワークがメンバーになっているデータセンターへの参照。 |
stp | ブール値：true または false | ネットワークに対してスパニングツリープロトコルを有効にするかどうかを指定します。 |
mtu | integer | ネットワークの最大伝送単位を指定します。 |
usages | complex | ネットワークの 使用 要素のセットを定義します。このレベルでネットワークを vm ネットワークおよび ディスプレイ ネットワークとして定義できます。 |
REST API では、標準の REST メソッドで
network サブコレクションを操作することができます。たとえば、POST メソッドを使用してネットワーク ID または 名前を更新できます。例9.10 ネットワークリソースのデータセンターとの関連付け
POST /ovirt-engine/api/datacenters/00000000-0000-0000-0000-000000000000/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/00000000-0000-0000-0000-000000000000/networks/00000000-0000-0000-0000-000000000000
Content-Type: application/xml
<network href="/ovirt-engine/api/networks/00000000-0000-0000-0000-000000000000"
id="00000000-0000-0000-0000-000000000000">
<name>Network_001</name>
<link href="/ovirt-engine/api/networks/00000000-0000-0000-0000-000000000000/permissions"
rel="permissions"/>
<link href="/ovirt-engine/api/networks/00000000-0000-0000-0000-000000000000/vnicprofiles"
rel="vnicprofiles"/>
<link href="/ovirt-engine/api/networks/00000000-0000-0000-0000-000000000000/labels"
rel="labels"/>
<data_center href="/ovirt-engine/api/datacenters/00000000-0000-0000-0000-000000000000"
id="00000000-0000-0000-0000-000000000000"/>
<stp>false</stp>
<mtu>0</mtu>
<usages>
<usage>vm</usage>
</usages>
</network>PUT 要求でリソースを更新します。ネットワークの最大伝送単位は、mtu 要素の整数値を指定する PUT 要求を使用して設定されます。
例9.11 ネットワーク最大伝送単位の設定
PUT /ovirt-engine/api/datacenters/00000000-0000-0000-0000-000000000000/networks/00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-Type: application/xml
<network>
<mtu>1500</mtu>
</network>
関連付けは、コレクション内の適切な要素への
DELETE 要求で削除されます。
例9.12 データセンターからのネットワーク関連付けの削除
DELETE /ovirt-engine/api/datacenters/00000000-0000-0000-0000-000000000000/networks/00000000-0000-0000-0000-000000000000 HTTP/1.1 HTTP/1.1 204 No Content
