Skip to content

Unofficial ClouDNS API Client compatible with Go 1.13

License

Notifications You must be signed in to change notification settings

wmarchesi123/cloudns-go

 
 

Repository files navigation

cloudns-go

License Documentation Go Compatibility GitHub issues Code Coverage Copyright

Summary

This is an unofficial library for the ClouDNS HTTP API written in Go. Currently all operations related to account, zone and record management have been fully implemented. Further information about the API can be found at the official ClouDNS website.

Quick Start

Initialize cloudns-go by creating a new API client instance with your preferred choice of credentials, which is a combination of the API user password and an user ID, sub-user ID or sub-user name:

client, err := cloudns.New(
    // You must only specify one of these options
    // AuthUserID has the highest set of privileges and access to everything
    // AuthSubUserID and AuthSubUserName are restricted
    cloudns.AuthUserID(42, "cloudns-rocks"),
    cloudns.AuthSubUserID(13, "what-a-lucky-day"),
    cloudns.AuthSubUserName("john", "doe"),
)

After confirming that no error has occurred, you may access the various services available underneath the client object, which currently consists of:

  • client.Accounts: Manage your ClouDNS account and sub-users
  • client.Zones: Manage DNS zones in your account
  • client.Records: Manage records inside a specific DNS zone

You can find more information about the specific methods and structures of cloudns-go by visiting the official documentation on godoc.org.

Example

package main

import (
	"context"
	"fmt"
	"github.com/ppmathis/cloudns-go"
)

func main() {
	client, _ := cloudns.New(
		cloudns.AuthUserID(42, "cloudns-rocks"),
	)

	zone, _ := client.Zones.Get(context.TODO(), "api-example.com")
	result1, _ := client.Zones.SetActive(context.TODO(), zone.Name, true)

	record := cloudns.NewRecord(cloudns.RecordTypeA, "localhost", "1.2.3.4", 3600)
	result2, _ := client.Records.Create(context.TODO(), zone.Name, record)

	fmt.Printf("Zone: % v\n", zone)
	fmt.Printf("Record: % v\n", record)
	fmt.Printf("Result of `Zones.SetActive()`: % v\n", result1)
	fmt.Printf("Result of `Records.Create()`: % v\n", result2)
}

About

Unofficial ClouDNS API Client compatible with Go 1.13

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 100.0%