15.6.2. Network Interfaces Sub-Collection
15.6.2.1. Network Interfaces Sub-Collection
nics 子集合表示虚拟机上的所有网络接口设备。nic representation 包含以下元素：
| 元素 | 类型 | Description | Properties |
|---|---|---|---|
link rel="statistics" | 关系 | 到虚拟机网络接口 统计的统计信息 子集合的链接。 | 
|
network id= | GUID | 对接口应该连接的网络的引用。允许空白网络 ID。 | 
|
interface | Enumerated | 用于 nic 的驱动程序类型。枚举的值列表包括在 能力 中。 | |
mac address= | 字符串 | 接口的 MAC 地址。 | 
|
port_mirroring | complex | 定义 NIC 是否接收镜像流量。定义包含一系列 。 | |
plugged | 布尔值 | 定义 NIC 是否插入到虚拟机。 |
|
链接 | 布尔值 | 定义 NIC 是否链接到虚拟机。 |
|
例 15.24. 网络接口的 XML 表示
<nic id="7a3cff5e-3cc4-47c2-8388-9adf16341f5e"
ref="/ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics/
7a3cff5e-3cc4-47c2-8388-9adf16341f5e">
<link rel="statistics"
href="/ovirt-engine/api/vms/082c794b-771f-452f-83c9-b2b5a19c0399/nics/
7a3cff5e-3cc4-47c2-8388-9adf16341f5e/statistics"/>
<name>nic1</name>
<interface>virtio</interface>
<mac address="00:1a:4a:16:84:07"/>
<network id="00000000-0000-0000-0000-000000000009"
href="/ovirt-engine/api/networks/00000000-0000-0000-0000-000000000009"/>
<vm id="cdc0b102-fbfe-444a-b9cb-57d2af94f401"
href="/ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401"/>
<port_mirroring>
<networks>
<network id="56087282-d7a6-11e1-af44-001a4a400e0c"
href="/ovirt-engine/api/networks/56087282-d7a6-11e1-af44-001a4a400e0c"/>
</networks>
</port_mirroring>
</nic>
添加新网络接口时，需要
name 和 network 元素。使用 id 属性或 name 元素标识 network 元素。
例 15.25. 创建虚拟机 NIC
POST /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics HTTP/1.1
Accept: application/xml
Content-type: application/xml
<nic>
<name>nic1</name>
<network id="00000000-0000-0000-0000-000000000009"/>
</nic>
API 用户使用
PUT 请求修改网络接口。
例 15.26. 更新虚拟机 NIC
PUT /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics/
7a3cff5e-3cc4-47c2-8388-9adf16341f5e HTTP/1.1
Accept: application/xml
Content-type: application/xml
<nic>
<name>nic2</name>
<network id="00000000-0000-0000-0000-000000000010"/>
<type>e1000</type>
</nic>
API 用户删除具有
DELETE 请求的网络接口。
例 15.27. 删除虚拟机 NIC
DELETE /ovirt-engine/api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/nics/ 7a3cff5e-3cc4-47c2-8388-9adf16341f5e HTTP/1.1 HTTP/1.1 204 No Content
重要
热插拔功能只支持具有热插操作的虚拟机操作系统。操作系统示例包括：
- Red Hat Enterprise Linux 6;
- Red Hat Enterprise Linux 5;
- Windows Server 2008；以及.
- Windows Server 2003.
