network

package
v1.26.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 20, 2021 License: MPL-2.0 Imports: 10 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func FromID

func FromID(client *govmomi.Client, id string) (object.NetworkReference, error)

FromID loads a network via its managed object reference ID.

func FromNameAndDVSUuid added in v1.21.0

func FromNameAndDVSUuid(client *govmomi.Client, name string, dc *object.Datacenter, dvsUuid string) (object.NetworkReference, error)

func FromPath

func FromPath(client *govmomi.Client, name string, dc *object.Datacenter) (object.NetworkReference, error)

FromPath loads a network via its path.

A network is a usually one of three kinds of networks: a DVS port group, a host port group, or a "opaque" network, provided externally from something like NSX. All three of these can be used as a backing for a virtual ethernet card, which is usually what these helpers are used with.

Datacenter is optional here - if not provided, it's expected that the path is sufficient enough for finder to determine the datacenter required.

func List added in v1.23.0

func Properties

func Properties(net *object.Network) (*mo.Network, error)

Properties gets the properties for a specific Network.

By itself, the Network type usually represents a standard port group in vCenter - it has been set up on a host or a set of hosts, and is usually configured via through an appropriate HostNetworkSystem. vCenter, however, groups up these networks and displays them as a single network that VM can use across hosts, facilitating HA and vMotion for VMs that use standard port groups versus DVS port groups. Hence the "Network" object is mainly a read-only MO and is only useful for checking some very base level attributes.

While other network MOs extend the base network object (such as DV port groups and opaque networks), this only works with the base object only. Refer to functions more specific to the MO to get a fully extended property set for the extended objects if you are dealing with those object types.

func ReferenceProperties

func ReferenceProperties(client *govmomi.Client, net object.NetworkReference) (*mo.Network, error)

ReferenceProperties is a convenience method that wraps fetching the Network MO from a NetworkReference.

Note that regardless of the network type, this only fetches the Network MO and not any of the extended properties of that network.

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL