9.5.2. 网络 Sub-Collection
9.5.2.1. 网络子注入
与数据中心关联的网络通过网络子集合表示。
网络 子集合的表示包含以下元素：
| 元素 | 类型 | 描述 |
|---|---|---|
name | 字符串 | 网络的纯文本，人类可读的名称。 |
description | 字符串 | 网络的纯文本、人类可读的描述。 |
rel="permissions" | 关系 | 到 网络权限 子集合的链接。 |
rel="vnicprofiles" | 关系 | 到网络的 vnicprofiles 子集合的链接。 |
rel="labels" | 关系 | 到网络 的标签 子集合的链接。 |
data_center id= | 关系 | 对网络所属的数据中心的引用。 |
stp | 布尔值： true 或 false | 指定是否为网络启用跨树协议。 |
mtu | 整数 | 指定网络的最大传输单元。 |
usages | complex | 定义网络的一组 使用 元素。用户可以将网络定义为 vm，并在此级别上 显示网络。 |
在 REST API 中，您可以使用标准的 REST 方法操作
网络 子集合。例如，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 请求更新资源。网络的最大传输单元使用 PUT 请求来设置，以指定 mtu 元素的整数值。
例 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
