loopia

README

libdns-loopia for libdns

This package implements the libdns interfaces for Loopia, allowing you to manage DNS records.

Usage

include (
    loopia "github.com/libdns/loopia"
)
p := &loopia.Provider{
    Username: "youruser@loopiaapi",
    Password: "yourpassword",
}

zone := "example.org"
records, err := p.GetRecords(ctx, zone)

For more details check the _examples folder in the source.

Noteworthy

If you are adding or chainging records, like acme/letsencrypt validation, Loopia is somewhat slow to propagate the result. It might take up to 15 minutes. That said, I have seen it come throug in as little as 1,5 minutes.

To do everything this library can do the Loopia API user needs access to the following...

• getSubdomains
• addSubdomain
• removeSubdomain
• getZoneRecords
• addZoneRecord
• updateZoneRecord
• removeZoneRecord

Documentation

Overview

Package libdns-loopia implements a DNS record management client compatible with the libdns interfaces for Loopia.

Index

• func Log() iLogger
• type Provider
  • func (p *Provider) AppendRecords(ctx context.Context, zone string, records []libdns.Record) ([]libdns.Record, error)
  • func (p *Provider) DeleteRecords(ctx context.Context, zone string, records []libdns.Record) ([]libdns.Record, error)
  • func (p *Provider) GetRecords(ctx context.Context, zone string) ([]libdns.Record, error)
  • func (p *Provider) SetRecords(ctx context.Context, zone string, records []libdns.Record) ([]libdns.Record, error)

Functions

func Log

func Log() iLogger

Types

type Provider

type Provider struct {
	Username string `json:"username,omitempty"`
	Password string `json:"password,omitempty"`
	Customer string `json:"customer,omitempty"`
	// contains filtered or unexported fields
}

Provider facilitates DNS record manipulation with Loopia.

func (*Provider) AppendRecords

func (p *Provider) AppendRecords(ctx context.Context, zone string, records []libdns.Record) ([]libdns.Record, error)

AppendRecords adds records to the zone. It returns the records that were added.

func (*Provider) DeleteRecords

func (p *Provider) DeleteRecords(ctx context.Context, zone string, records []libdns.Record) ([]libdns.Record, error)

DeleteRecords deletes the records from the zone. It returns the records that were deleted.

func (*Provider) GetRecords

func (p *Provider) GetRecords(ctx context.Context, zone string) ([]libdns.Record, error)

GetRecords lists all the records in the zone.

func (*Provider) SetRecords

func (p *Provider) SetRecords(ctx context.Context, zone string, records []libdns.Record) ([]libdns.Record, error)

SetRecords sets the records in the zone, either by updating existing records or creating new ones. It returns the updated records.