6.145. Network

論理ネットワークを取得します。

以下に例を示します。

GET /ovirt-engine/api/networks/123

以下を応答します。

<network href="/ovirt-engine/api/networks/123" id="123">
  <name>ovirtmgmt</name>
  <description>Default Management Network</description>
  <link href="/ovirt-engine/api/networks/123/permissions" rel="permissions"/>
  <link href="/ovirt-engine/api/networks/123/vnicprofiles" rel="vnicprofiles"/>
  <link href="/ovirt-engine/api/networks/123/networklabels" rel="networklabels"/>
  <mtu>0</mtu>
  <stp>false</stp>
  <usages>
    <usage>vm</usage>
  </usages>
  <data_center href="/ovirt-engine/api/datacenters/456" id="456"/>
</network>

論理ネットワーク、または論理ネットワークのデータセンターへの関連付けを削除します。

たとえば、論理ネットワーク 123 を削除するには、以下のような要求を送信します。

DELETE /ovirt-engine/api/networks/123

各ネットワークは、1 つのデータセンターに厳密にバインドされています。したがって、ネットワークとデータセンターの関連付けを解除すると、そのネットワークを単に削除した場合と同じ結果になります。ただし、データセンター 123 のネットワーク 456 を削除すると言う方がより具体的かもしれません。

たとえば、ネットワーク 456 とデータセンター 123 の関連付けを削除するには、以下のような要求を送信します。

DELETE /ovirt-engine/api/datacenters/123/networks/456

論理ネットワークを更新します。

name、description、ip、vlan、stp、および display 属性を更新できます。

たとえば、論理ネットワーク 123 の説明を更新するには、以下のようなリクエストを送信します。

PUT /ovirt-engine/api/networks/123

リクエスト本文は以下のようになります。

<network>
  <description>My updated description</description>
</network>

ネットワークの最大伝送単位は、mtu 属性の整数値を指定する PUT 要求を使用して設定されます。

たとえば、最大伝送単位を設定するには、以下のようなリクエストを送信します。

PUT /ovirt-engine/api/datacenters/123/networks/456

リクエスト本文は以下のようになります。

<network>
  <mtu>1500</mtu>
</network>