Documentation ¶
Overview ¶
This package is the root package of the govmomi library.
The library is structured as follows:
Package vim25 ¶
The minimal usable functionality is available through the vim25 package. It contains subpackages that contain generated types, managed objects, and all available methods. The vim25 package is entirely independent of the other packages in the govmomi tree -- it has no dependencies on its peers.
The vim25 package itself contains a client structure that is passed around throughout the entire library. It abstracts a session and its immutable state. See the vim25 package for more information.
Package session ¶
The session package contains an abstraction for the session manager that allows a user to login and logout. It also provides access to the current session (i.e. to determine if the user is in fact logged in)
Package object ¶
The object package contains wrappers for a selection of managed objects. The constructors of these objects all take a *vim25.Client, which they pass along to derived objects, if applicable.
Package govc ¶
The govc package contains the govc CLI. The code in this tree is not intended to be used as a library. Any functionality that govc contains that _could_ be used as a library function but isn't, _should_ live in a root level package.
Other packages ¶
Other packages, such as "event", "guest", or "license", provide wrappers for the respective subsystems. They are typically not needed in normal workflows so are kept outside the object package.
Index ¶
- type Client
- func (c *Client) Login(ctx context.Context, u *url.Userinfo) error
- func (c *Client) LoginExtensionByCertificate(ctx context.Context, key string, locale string) error
- func (c *Client) Logout(ctx context.Context) error
- func (c *Client) PropertyCollector() *property.Collector
- func (c *Client) Retrieve(ctx context.Context, objs []types.ManagedObjectReference, p []string, ...) error
- func (c *Client) RetrieveOne(ctx context.Context, obj types.ManagedObjectReference, p []string, ...) error
- func (c *Client) Wait(ctx context.Context, obj types.ManagedObjectReference, ps []string, ...) error
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Client ¶
func NewClient ¶
NewClient creates a new client from a URL. The client authenticates with the server with username/password before returning if the URL contains user information.
func NewClientWithCertificate ¶
func NewClientWithCertificate(ctx context.Context, u *url.URL, insecure bool, cert tls.Certificate) (*Client, error)
NewClientWithCertificate creates a new client from a URL. The client authenticates with the server with the certificate before returning if the URL contains user information.
func (*Client) LoginExtensionByCertificate ¶
Login dispatches to the SessionManager.
func (*Client) PropertyCollector ¶
PropertyCollector returns the session's default property collector.
func (*Client) Retrieve ¶
func (c *Client) Retrieve(ctx context.Context, objs []types.ManagedObjectReference, p []string, dst interface{}) error
Retrieve dispatches to the Retrieve function on the default property collector.
func (*Client) RetrieveOne ¶
func (c *Client) RetrieveOne(ctx context.Context, obj types.ManagedObjectReference, p []string, dst interface{}) error
RetrieveOne dispatches to the Retrieve function on the default property collector.
Directories ¶
Path | Synopsis |
---|---|
examples
|
|
Package ovf provides functionality to unmarshal and inspect the structure of an OVF file.
|
Package ovf provides functionality to unmarshal and inspect the structure of an OVF file. |
Package test contains functions that implement common functionality between tests.
|
Package test contains functions that implement common functionality between tests. |
Package vim25 provides a minimal client implementation to use with other packages in the vim25 tree.
|
Package vim25 provides a minimal client implementation to use with other packages in the vim25 tree. |
xml
Package xml implements a simple XML 1.0 parser that understands XML name spaces.
|
Package xml implements a simple XML 1.0 parser that understands XML name spaces. |