1
[![Build Status](https://travis-ci.org/vmware/govmomi.png?branch=master)](https://travis-ci.org/vmware/govmomi)
5
A Go library for interacting with VMware vSphere APIs (ESXi and/or vCenter).
7
For `govc`, a CLI built on top of govmomi, check out the [govc](./govc) directory.
11
This library is built for and tested against ESXi and vCenter 5.5.
13
If you're able to use it against older versions of ESXi and/or vCenter, please
14
leave a note and we'll include it in this compatibility list.
18
The APIs exposed by this library very closely follow the API described in the [VMware vSphere API Reference Documentation][apiref].
19
Refer to this document to become familiar with the upstream API.
21
The code in the `govmomi` package is a wrapper for the code that is generated from the vSphere API description.
22
It primarily provides convenience functions for working with the vSphere API.
23
See [godoc.org][godoc] for documentation.
25
[apiref]:http://pubs.vmware.com/vsphere-55/index.jsp#com.vmware.wssdk.apiref.doc/right-pane.html
26
[godoc]:http://godoc.org/github.com/vmware/govmomi
30
Changes to the API are subject to [semantic versioning](http://semver.org).
32
Refer to the [CHANGELOG](CHANGELOG.md) for version to version changes.
36
govmomi is available under the [Apache 2 license](LICENSE).