This community project provides bindings for the currently latest version of PowerDNS.
- Zone handling
- Resource record handling
- Server statistics gathering
- DNSSEC handling
For more features, consult our documentation.
import "github.com/joeig/go-powerdns/v2"
pdns := powerdns.NewClient("http://localhost:80", "localhost", map[string]string{"X-API-Key": "apipw"}, nil)
Assuming that the server is listening on http://localhost:80 for virtual host localhost
, the API password is apipw
and you want to edit the domain example.com
.
zones, err := pdns.Zones.List()
zone, err := pdns.Zones.Get("example.com")
export, err := pdns.Zones.Export("example.com")
zone, err := pdns.Zones.AddNative("example.com", true, "", false, "foo", "foo", true, []string{"ns.foo.tld."})
zone, err := pdns.Zones.Add(&powerdns.Zone{})
err := pdns.Zones.Change("example.com", &zone)
err := pdns.Zones.Delete("example.com")
err := pdns.Records.Add("example.com", "www.example.com", powerdns.RRTypeAAAA, 60, []string{"::1"})
err := pdns.Records.Change("example.com", "www.example.com", powerdns.RRTypeAAAA, 3600, []string{"::1"})
err := pdns.Records.Delete("example.com", "www.example.com", powerdns.RRTypeA)
statistics, err := pdns.Statistics.List()
servers, err := pdns.Servers.List()
server, err := pdns.Servers.Get("localhost")
cryptokeys, err := pdns.Cryptokeys.List()
cryptokey, err := pdns.Cryptokeys.Get("example.com", "1337")
err := pdns.Cryptokeys.Delete("example.com", "1337")
See examples.
- PowerDNS 4.x ("API v1")
--webserver=yes --api=yes --api-key=apipw --api-readonly=no
- Note that API v1 is actively maintained. There are major differences between 3.x, 4.0 and 4.1 and this client works only with 4.1 and 4.2.
- Tested with Go version 1.12/1.13/1.14, according to Go's version support policy (should work with other minor releases as well)
go get -u github.com/joeig/go-powerdns
See GoDoc.
This API client has not been completed yet, so feel free to contribute. The OpenAPI specification might be a good reference.
Start a PowerDNS authoritative server including a generic MySQL backend, DNSSEC support and some fixtures using Docker compose:
docker-compose -f docker-compose-v4.2.yml up
docker-compose -f docker-compose-v4.2.yml exec powerdns sh init_docker_fixtures.sh
It's also possible to target mocks against this server:
make test-without-mocks