d6c051caf9 | ||
---|---|---|
.. | ||
types/v56 | ||
LICENSE | ||
Makefile | ||
README.md | ||
api.go | ||
api_vca.go | ||
api_vcd.go | ||
catalog.go | ||
catalogitem.go | ||
edgegateway.go | ||
org.go | ||
orgvdcnetwork.go | ||
query.go | ||
task.go | ||
vapp.go | ||
vapptemplate.go | ||
vdc.go | ||
vm.go |
README.md
govcloudair
This repo provides the govcloudair
package which offers an interface to the vCloud Air 5.6 and 5.7 API and vCloud Director 5.5 API.
It serves as a foundation for a project currently in development, there are plans to make it a general purpose API in the future. The govcloudair
package is used by the Terraform provider for vCloud Director.
The API is currently under heavy development, its coverage is extremely limited at the moment.
The bindings now support both Subscription and On-demand accounts and vCloud Director 5.5
Example
package main
import (
"fmt"
"net/url"
"os"
govcd "github.com/ukcloud/govcloudair"
)
type Config struct {
User string
Password string
Org string
Href string
VDC string
Insecure bool
}
func (c *Config) Client() (*govcd.VCDClient, error) {
u, err := url.ParseRequestURI(c.Href)
if err != nil {
return nil, fmt.Errorf("Unable to pass url: %s", err)
}
vcdclient := govcd.NewVCDClient(*u, c.Insecure)
org, vcd, err := vcdclient.Authenticate(c.User, c.Password, c.Org, c.VDC)
if err != nil {
return nil, fmt.Errorf("Unable to authenticate: %s", err)
}
vcdclient.Org = org
vcdclient.OrgVdc = vcd
return vcdclient, nil
}
func main() {
config := Config{
User: "Username",
Password: "password",
Org: "vcd org",
Href: "vcd api url",
VDC: "vcd virtual datacenter name",
}
client, err := config.Client() // We now have a client
if err != nil {
fmt.Println(err)
os.Exit(1)
}
fmt.Printf("Org URL: %s\n", client.OrgHREF.String())
}