Managed Object - Network

Property of: ComputeResource, Datacenter, HostSystem, NetworkSummary, VirtualEthernetCardNetworkBackingInfo, VirtualMachine
See also: HostSystem, NetworkSummary, VirtualMachine

Managed Object Description

Represents a network accessible by either hosts or virtual machines. This can be a physical network or a logical network, such as a VLAN.

Networks are created:

explicitly when configuring a host.
automatically when adding a host to VirtualCenter.
automatically when adding a new virtual machine to a host or to VirtualCenter.

Properties

Name	Type	Description
host*	ManagedObjectReference[] to a HostSystem[]	Hosts attached to this network.
name	xsd:string	Name of this network.
summary	NetworkSummary	Properties of a network.
vm*	ManagedObjectReference[] to a VirtualMachine[]	Virtual machines using this network.

*May not be present

Methods

Methods defined in this Managed Object
DestroyNetwork

DestroyNetwork

Removes a network. A network can be removed only if it is not used by any host or virtual machine.

Required Privileges: Network.Delete

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the Network used to make the method call.

Return Value

Type	Description
None

Faults

Type	Description
ResourceInUse	Thrown if one or more hosts or virtual machines are configured to use the network.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" name="DestroyNetwork">
            <complexType>
               <sequence>
                  <element name="_this" type="vim2:ManagedObjectReference"/>
               </sequence>
            </complexType>
         </element>
         <element xmlns="http://www.w3.org/2001/XMLSchema" name="DestroyNetworkResponse">
            <complexType/>
         </element>