Go library for the VMware vSphere API
Go Shell Emacs Lisp Other
Clone or download
dougm Merge pull request #1176 from dougm/vcsim-dvs
vcsim: do not include DVS in HostSystem.Network
Latest commit 0627a5e Jul 14, 2018
Permalink
Failed to load latest commit information.
event Add option to filter events by type (#976) Dec 21, 2017
examples example: uniform unit for host memory May 27, 2018
find Finder.DefaultHostSystem should find hosts in nested folders Apr 25, 2018
gen Update to vSphere 6.7 API Apr 21, 2018
govc Upgrade for govc tags commands Jul 9, 2018
guest Several context changes: Jan 25, 2018
internal vim25: Move internal stuff to internal package Sep 26, 2017
license vcsim: Implement add/remove license Sep 27, 2017
list Finder: support automatic Folder recursion (#663) Feb 13, 2017
lookup Lookup Service support Apr 2, 2018
nfc Several context changes: Jan 25, 2018
object Better documentation for VirtualMachine.UUID Jul 3, 2018
ovf SAML token authentication support Mar 24, 2018
pbm Update to vSphere 6.7 API Apr 21, 2018
performance Add unit conversion to metric CSV Mar 14, 2017
property Avoid property.Filter matching against unset properties Apr 23, 2018
scripts Use govc find instead of ls to assign licenses Jul 9, 2018
session Refactor LoginExtensionByCertificate tunnel usage Apr 6, 2018
simulator vcsim: do not include DVS in HostSystem.Network Jul 14, 2018
ssoadmin Avoid panic if fault detail is nil Jul 9, 2018
sts vcsim: add STS simulator May 8, 2018
task Handle nil TaskInfo in task.Wait callback #2 (#666) Feb 16, 2017
test Bump to 1.7 and start using new context pkg Aug 22, 2016
toolbox toolbox: validate request offset in ListFiles (#946) Dec 11, 2017
units Doc updates Jun 6, 2017
vapi/tags Upgrade for govc tags commands Jul 9, 2018
vcsim vcsim: add STS simulator May 8, 2018
vendor/github.com Dep Support Mar 21, 2018
view govc: add tasks and task.cancel commands Aug 1, 2017
vim25 Avoid panic if fault detail is nil Jul 9, 2018
vmdk Use ovf to import vmdk Jul 28, 2017
.gitignore Add goreleaser to automate release process Mar 16, 2018
.goreleaser.yml Add goreleaser to automate release process Mar 16, 2018
.mailmap Update docs for 0.18 release May 24, 2018
.travis.yml Only test with Go 1.10 on Travis CI Jul 9, 2018
CHANGELOG.md Optionally check root CAs for validity (#1154) Jun 18, 2018
CONTRIBUTING.md Doc updates Jun 6, 2017
CONTRIBUTORS Update docs for 0.18 release May 24, 2018
Dockerfile Add goreleaser to automate release process Mar 16, 2018
Gopkg.lock Dep Support Mar 21, 2018
Gopkg.toml Dep Support Mar 21, 2018
LICENSE.txt Rename LICENSE file Apr 2, 2015
Makefile vcsim: avoid data races Jan 23, 2018
README.md Update docs for 0.18 release May 24, 2018
client.go Refactor LoginExtensionByCertificate tunnel usage Apr 6, 2018
client_test.go Lookup Service support Apr 2, 2018

README.md

Build Status Go Report Card

govmomi

A Go library for interacting with VMware vSphere APIs (ESXi and/or vCenter).

In addition to the vSphere API client, this repository includes:

  • govc - vSphere CLI

  • vcsim - vSphere API mock framework

  • toolbox - VM guest tools framework

Compatibility

This library is built for and tested against ESXi and vCenter 6.0, 6.5 and 6.7.

It may work with versions 5.5 and 5.1, but neither are officially supported.

Documentation

The APIs exposed by this library very closely follow the API described in the VMware vSphere API Reference Documentation. Refer to this document to become familiar with the upstream API.

The code in the govmomi package is a wrapper for the code that is generated from the vSphere API description. It primarily provides convenience functions for working with the vSphere API. See godoc.org for documentation.

Installation

go get -u github.com/vmware/govmomi

Discussion

Contributors and users are encouraged to collaborate using GitHub issues and/or Slack. Access to Slack requires a VMware {code} membership.

Status

Changes to the API are subject to semantic versioning.

Refer to the CHANGELOG for version to version changes.

Projects using govmomi

Related projects

License

govmomi is available under the Apache 2 license.