vCloud Air API bindings for Golang
Switch branches/tags
Clone or download
#16 Compare This branch is 61 commits ahead of vmware:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
hack
scripts
testutil
types/v56
v57
.drone.sec
.drone.yml
.editorconfig
.gitignore
.travis.yml
LICENSE
Makefile
README.md
api.go
api_test.go
api_vca.go
api_vca_test.go
api_vcd.go
api_vcd_test.go
catalog.go
catalog_test.go
catalogitem.go
catalogitem_test.go
edgegateway.go
edgegateway_test.go
org.go
org_test.go
orgvdcnetwork.go
orgvdcnetwork_test.go
query.go
query_test.go
task.go
task_test.go
vapp.go
vapp_test.go
vapptemplate.go
vapptemplate_test.go
vdc.go
vdc_test.go
vm.go
vm_test.go

README.md

govcloudair Build Status Build Status Coverage Status GoDoc Join the chat at https://gitter.im/ukcloud/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())
}