AttachL3NetworkToVm

Attaches an L3 network to a VM instance that is in Running or Stopped state. For example,
AttachL3NetworkToVm vmInstanceUuid=7c4162e8d32d4bea8f7e799024c6b735 l3NetworkUuid=e10b482d91964ef5b59af7f1d27cbd8f

Parameters

Name Description Optional Valid Value Starting Version
vmInstanceUuid The VM instance UUID. 0.6
l3NetworkUuid The L3 network UUID. 0.6
driverType The NIC driver type.
  • E1000E
  • E1000
  • Vmxnet3
  • Sriov
 4.0.0
staticIp Specifies the IP address to be allocated to the VM instance. Yes 0.6
userTags The user tags. For more information, see CreateUserTag. The resource type is VmInstanceVO. Yes 0.6
systemTags The system tags. For more information, see CreateSystemTag. The resource type is VmInstanceVO. Yes 0.6
timeout Yes
Note:
  • When you attach an L3 network to a VM instance in ZStack Cloud, you can enable SR-IOV by adding the enableSRIOV option to SystemTags.
    • Format of the enableSRIOV option: enableSRIOV::{L3_NETWORK_UUID}
    • Example: enableSRIOV::9e19dafe81c64fed8e34f72e27582339
  • When you create a VM instance in ZStack Cloud, you can specify an IP address for the L3 network by adding the staticIp option to SystemTags. If the network address type is double stack (IPv4+IPv6), you can add two staticIp options, which are IPv4 and IPv6, respectively.
    • Format of the staticIp option: staticIp::L3 network UUID::specified IP
    • Example: staticIp::81a21a81cde84c1084c191354053a3b5::172.20.196.0