A fully featured go sdk for vcloud director
To install:
$ go get github.com/r3labs/vcloud-go-sdkTo create a new client:
import (
"github.com/r3labs/vcloud-go-sdk/models"
"github.com/r3labs/vcloud-go-sdk/config"
"github.com/r3labs/vcloud-go-sdk/client"
)
func main() {
cfg := config.New("https://vcloud/", "27.0").WithCredentials("username", "password")
vcloud := client.New(cfg)
err := vcloud.Authenticate()
}To list all organisations:
orgs, err := vcloud.Orgs.List()To get an organisation by name:
orgs, err := vcloud.Orgs.List()
if err != nil {
return nil, err
}
orgID := orgs.ByName("my-org")[0].ID()
org, err := vcloud.Orgs.Get(orgID)To list all vdc's:
orgs, err := vcloud.Orgs.List()
if err != nil {
return nil, err
}
orgID := orgs.ByName("my-org")[0].ID()
org, err := vcloud.Orgs.Get(orgID)
vdcLinks := o.Links.ByType(models.TypesVdc)To get a vdc by name:
vdcLink := o.Links.ByType(models.TypesVdc).ByName("my-vdc")
vdc, err := vcloud.Vdcs.Get(vdcLink[0].ID())To list all instances in a vdc:
...
vdc, err := vcloud.Vdcs.Get(vdcLink[0].ID())
vapps := vdc.VAppRefs()To create a new vApp from a vApp template:
...
vdc, err := vcloud.Vdcs.Get(vdcLink[0].ID())
// retrieve network reference
nwref := vdc.NetworkRefs().Get("my-network")
// retrieve vapp template reference from catalog
catref := org.CatalogRefs().Get("my-vapp-catalog")
catalog, err := vcloud.Catalogs.Get(catref.ID())
templateref := catalog.Items().ByName("my-vapp-template")
template, err := vcloud.Catalogs.GetItem(templateref.GetID())
// create vapp request
params := &models.InstantiateVAppParams{
Name: "my-new-vapp",
Description: "vapp from a template",
AcceptEULAs: true,
Deploy: false,
PowerOn: false,
}
params.SetNetwork(nwref.Name, "bridged", nwref.Href)
params.SetSource("my-vapp-template", template.Entity.Href)
// create vapp and wait for task to complete
vapp, err := vcloud.VApps.Create(vdc.GetID(), params)
for _, task := range vapp.GetTasks() {
err = vcloud.Tasks.Wait(&task)
}To start/stop a vm:
vm := vapp.Children.Vms[0]
task, err = vcloud.Vms.PowerOff(vm.GetID())
task, err = vcloud.Vms.PowerOn(vm.GetID())
err = vcloud.Tasks.Wait(task)To list all vdc networks:
networkRefs := vdc.NetworkRefs()To get a network by name:
networkRef := vdc.NetworkRefs().Get("my-network")
network, err := vcloud.Networks.Get(networkRef.ID())To list all edge gateways:
gatewayRecords, err := vcloud.Queries.RecordsFilter(models.QueryEdgeGateway, "vdc=="+vdc.Href, "1")To get a edge gateway by name:
gatewayRecords, err := vcloud.Queries.RecordsFilter(models.QueryEdgeGateway, "vdc=="+vdc.Href, "1")
id := gatewayRecords.EdgeGatewayRecords[0].ID()
gateway, err := vcloud.Gateways.Get(id)Please read through our contributing guidelines. Included are directions for opening issues, coding standards, and notes on development.
Moreover, if your pull request contains patches or features, you must include relevant unit tests.
Code and documentation copyright since 2017 ernest.io authors.
Code released under the Mozilla Public License Version 2.0.