computeresource

Documentation

Index

• func BaseProperties(obj BaseComputeResource) (*mo.ComputeResource, error)
• func BasePropertiesFromReference(client *govmomi.Client, ref types.ManagedObjectReference) (*mo.ComputeResource, error)
• func ClusterFromID(client *govmomi.Client, id string) (*object.ClusterComputeResource, error)
• func DefaultDevicesFromReference(client *govmomi.Client, ref types.ManagedObjectReference, guest string) (object.VirtualDeviceList, error)
• func EnvironmentBrowserFromReference(client *govmomi.Client, ref types.ManagedObjectReference) (*envbrowse.EnvironmentBrowser, error)
• func OSFamily(client *govmomi.Client, ref types.ManagedObjectReference, guest string) (string, error)
• func StandaloneFromID(client *govmomi.Client, id string) (*object.ComputeResource, error)
• type BaseComputeResource
  • func BaseFromPath(client *govmomi.Client, path string) (BaseComputeResource, error)
  • func BaseFromReference(client *govmomi.Client, ref types.ManagedObjectReference) (BaseComputeResource, error)

Functions

func BaseProperties

func BaseProperties(obj BaseComputeResource) (*mo.ComputeResource, error)

BaseProperties returns the base-level ComputeResource managed object for a BaseComputeResource, an interface that any base-level ComputeResource and derivative object implements.

Note that this does not return any cluster-level attributes.

func BasePropertiesFromReference

func BasePropertiesFromReference(client *govmomi.Client, ref types.ManagedObjectReference) (*mo.ComputeResource, error)

BasePropertiesFromReference combines BaseFromReference and BaseProperties to get a base-level ComputeResource managed object for a specific managed object reference.

func ClusterFromID

func ClusterFromID(client *govmomi.Client, id string) (*object.ClusterComputeResource, error)

ClusterFromID returns a ClusterComputeResource, a subclass of ComputeResource that is used for clusters.

func DefaultDevicesFromReference

func DefaultDevicesFromReference(client *govmomi.Client, ref types.ManagedObjectReference, guest string) (object.VirtualDeviceList, error)

DefaultDevicesFromReference fetches the default virtual device list for a specific compute resource from a supplied managed object reference.

func EnvironmentBrowserFromReference

func EnvironmentBrowserFromReference(client *govmomi.Client, ref types.ManagedObjectReference) (*envbrowse.EnvironmentBrowser, error)

EnvironmentBrowserFromReference loads an environment browser for the specific compute resource reference. The reference can be either a standalone host or cluster.

As an added safety feature if the compute resource properties come back with an unset environmentBrowser attribute, this function will return an error. This is to protect against cases where this may come up such as licensing issues or clusters without hosts.

func OSFamily

func OSFamily(client *govmomi.Client, ref types.ManagedObjectReference, guest string) (string, error)

OSFamily uses the compute resource's environment browser to get the OS family for a specific guest ID.

func StandaloneFromID

func StandaloneFromID(client *govmomi.Client, id string) (*object.ComputeResource, error)

StandaloneFromID locates a ComputeResource by its managed object reference ID.

Note this is for base level ComputeResource objects only, and should only be used for standalone hosts. If you are looking for a cluster, use ClusterFromID.

Types

type BaseComputeResource

type BaseComputeResource interface {
	Datastores(context.Context) ([]*object.Datastore, error)
	Destroy(context.Context) (*object.Task, error)
	Hosts(context.Context) ([]*object.HostSystem, error)
	Reconfigure(context.Context, types.BaseComputeResourceConfigSpec, bool) (*object.Task, error)
	ResourcePool(context.Context) (*object.ResourcePool, error)

	Name() string
	Properties(context.Context, types.ManagedObjectReference, []string, interface{}) error
	Reference() types.ManagedObjectReference
	String() string
}

BaseComputeResource is an interface that ComputeResource and any derivative types will implement on part of having all of the methods available to ComputeResource. It also contains the Properties method from the common-level object method set.

Its use is mainly to facilitate common functionality between the two in helpers.

func BaseFromPath

func BaseFromPath(client *govmomi.Client, path string) (BaseComputeResource, error)

BaseFromPath returns a BaseComputeResource for a given path.

func BaseFromReference

func BaseFromReference(client *govmomi.Client, ref types.ManagedObjectReference) (BaseComputeResource, error)

BaseFromReference returns a BaseComputeResource for a given managed object reference.