hcloud: A Go library for the Hetzner Cloud API

Package hcloud is a library for the Hetzner Cloud API.

The library’s documentation is available at GoDoc, the public API documentation is available at docs.hetzner.cloud.

Example

package main

import (
    "context"
    "fmt"
    "log"

    "github.com/aaronriedel/hcloud-go/hcloud"
)

func main() {
    client := hcloud.NewClient(hcloud.WithToken("token"))

    server, _, err := client.Server.GetByID(context.Background(), 1)
    if err != nil {
        log.Fatalf("error retrieving server: %s\n", err)
    }
    if server != nil {
        fmt.Printf("server 1 is called %q\n", server.Name)
    } else {
        fmt.Println("server 1 not found")
    }
}

Go Version Support

The library supports the latest two Go minor versions, e.g. at the time Go 1.19 is released, it supports Go 1.18 and 1.19.

This matches the official Go Release Policy.

When the minimum required Go version is changed, it is announced in the release notes for that version.

License

MIT license