9:40 p.m.
Hi Archana,
Could you join this patch with the other one?
So it is better to me to identify how the patches are related and which
ones should be merged together.
More comments below:
On 08/22/2016 03:10 PM, archus(a)linux.vnet.ibm.com wrote:
From: Archana Singh <archus(a)linux.vnet.ibm.com>
Updated API.md to reflect the changes done in previous patch for adding,
removing, listing host network interfaces in template GET and PUT
APIs implementations.
Signed-off-by: Archana Singh <archus(a)linux.vnet.ibm.com>
---
docs/API.md | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/docs/API.md b/docs/API.md
index 7bd677f..3808054 100644
--- a/docs/API.md
+++ b/docs/API.md
@@ -428,6 +428,12 @@ A interface represents available network interface on VM.
* cdrom: A volume name or URI to an ISO image
* storagepool: URI of the storagepool where template allocates vm storage.
* networks *(optional)*: list of networks will be assigned to the new VM.
+ * interfaces *(optional)*: list of host network interfaces will be assigned to the
new VM.
IMO it is better to make clear this parameter is exclusively for s390x.
Or will not it be s390x exclusively?
+ * type: Type of host network interface. Type should be
'macvtap' for host network interface(Ethernet, Bond, VLAN) to be connected as
direct MacVTap or type should be ovs for openvswitch host network interface to be
connected as virtual switch to a VM.
"Type of host network interface. Type should be 'macvtap' for host
network interface (Ethernet, Bond, VLAN) to be connected as direct
MacVTap; or 'ovs' for openvswitch host network interface to be connected
as virtual switch to a VM. "
+ * name: The host network interface. It should be host
network interface(Ethernet, Bond, VLAN) for type 'macvtap' or host openvswitch
bridge interface for type ovs.
"The host network interface. It should be the host network interface
(Ethernet, Bond, VLAN) for type 'macvtap' or host openvswitch bridge
interface for type 'ovs'. "
+ * mode *(optional)*: Only applicable for interface type
macvtap, to indicates whether packets will be delivered directly to target device(bridge)
or to the external bridge(vepa-capable bridge).
+ * bridge: If packets have a destination on the host from which they
originated, they are delivered directly to the target. For direct delivery, both origin
and destination devices need to be in bridge mode. If either the origin or destination is
in vepa mode, VEPA-capable bridge is required.
+ * vepa: All packets are sent to the external bridge. If packets have a
destination on the host from which they originated, the VEPA-capable bridge will return
the packets to the host.
* disks: An array of requested disks with the following optional fields
(either *size* or *volume* must be specified):
* index: The device index
@@ -473,6 +479,12 @@ A interface represents available network interface on VM.
over current will be used exclusively for memory hotplug
* cdrom: A volume name or URI to an ISO image
* networks *(optional)*: list of networks will be assigned to the new VM.
> + * interfaces *(optional)*: list of host network interfaces will be assigned to
the new VM.
+ * type: Type of host network interface. Type should be
'macvtap' for host network interface(Ethernet, Bond, VLAN) to be connected as
direct MacVTap or type should be ovs for openvswitch host network interface to be
connected as virtual switch to a VM.
+ *
name: The host network interface. It should be host network interface(Ethernet, Bond,
VLAN) for type 'macvtap' or host openvswitch bridge interface for type ovs.
> + * mode *(optional)*: Only applicable for interface type macvtap, to
indicates whether packets will be delivered directly to target device(bridge) or to the
external bridge(vepa-capable bridge).
> + * bridge: If packets have a destination on the host from which they
originated, they are delivered directly to the target. For direct delivery, both origin
and destination devices need to be in bridge mode. If either the origin or destination is
in vepa mode, VEPA-capable bridge is required.
> + * vepa: All packets are sent to the external bridge. If packets have a
destination on the host from which they originated, the VEPA-capable bridge will return
the packets to the host.
The same comments I made above.
* disks: An array of requested disks with the following
optional fields
(either *size* or *volume* must be specified):
* index: The device index