gotransip - TransIP API client for Go
This is the Go client for the TransIP API. To use it you need an account with TransIP, enable API usage and setup a private API key.
NOTE: We keep the PHP version and golang version close as possible, but if something is not working 100% like you'd expect, please open an issue and of course: you're welcome to contribute!
Example usage
To print a list of your account's VPSes:
package main
import (
"fmt"
"github.com/transip/gotransip/v6"
"github.com/transip/gotransip/v6/vps"
)
func main() {
// create a new TransIP API client
client, err := gotransip.NewClient(gotransip.ClientConfiguration{
AccountName: "accountName",
PrivateKeyPath: "/path/to/api/private.key",
})
if err != nil {
panic(err.Error())
}
vpsRepo := vps.Repository{Client: client}
// get a list of your VPSes
vpss, err := vpsRepo.GetAll()
if err != nil {
panic(err.Error())
}
pnRepo := vps.PrivateNetworkRepository{Client: client}
// get a list of your private networks
pns, err := pnRepo.GetAll()
if err != nil {
panic(err.Error())
}
// print name and description for each VPS
for _, v := range vpss {
fmt.Printf("vps: %s (%s)\n", v.Name, v.Description)
}
// print name and description for each private network
for _, pn := range pns {
fmt.Printf("privatenetwork: %s (%s)\n", pn.Name, pn.Description)
}
// order a new ubuntu 18.04 x8 vps, specifying a custom description,
// so we can find out when the vps is delivered
err = vpsRepo.Order(vps.Order{
ProductName: "vps-bladevps-x8",
OperatingSystem: "ubuntu-18.04",
AvailabilityZone: "ams0",
Hostname: "webserver01",
Description: "my-unique-description",
})
if err != nil {
panic(err.Error())
}
}Documentation
For detailed descriptions of all functions, check out the TransIP API documentation. Details about the usage of the Go client can be found on pkg.go.dev.