1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123
|
package govultr
import (
"context"
"fmt"
"net/http"
"github.com/google/go-querystring/query"
)
// DomainRecordService is the interface to interact with the DNS Records endpoints on the Vultr API
// Link: https://www.vultr.com/api/#tag/dns
type DomainRecordService interface {
Create(ctx context.Context, domain string, domainRecordReq *DomainRecordReq) (*DomainRecord, error)
Get(ctx context.Context, domain, recordID string) (*DomainRecord, error)
Update(ctx context.Context, domain, recordID string, domainRecordReq *DomainRecordReq) error
Delete(ctx context.Context, domain, recordID string) error
List(ctx context.Context, domain string, options *ListOptions) ([]DomainRecord, *Meta, error)
}
// DomainRecordsServiceHandler handles interaction with the DNS Records methods for the Vultr API
type DomainRecordsServiceHandler struct {
client *Client
}
// DomainRecord represents a DNS record on Vultr
type DomainRecord struct {
ID string `json:"id,omitempty"`
Type string `json:"type,omitempty"`
Name string `json:"name,omitempty"`
Data string `json:"data,omitempty"`
Priority int `json:"priority,omitempty"`
TTL int `json:"ttl,omitempty"`
}
// DomainRecordReq struct to use for create/update domain record calls.
type DomainRecordReq struct {
Name string `json:"name"`
Type string `json:"type,omitempty"`
Data string `json:"data,omitempty"`
TTL int `json:"ttl,omitempty"`
Priority *int `json:"priority,omitempty"`
}
type domainRecordsBase struct {
Records []DomainRecord `json:"records,omitempty"`
Meta *Meta `json:"meta,omitempty"`
}
type domainRecordBase struct {
Record *DomainRecord `json:"record,omitempty"`
}
// Create will add a DNS record.
func (d *DomainRecordsServiceHandler) Create(ctx context.Context, domain string, domainRecordReq *DomainRecordReq) (*DomainRecord, error) {
req, err := d.client.NewRequest(ctx, http.MethodPost, fmt.Sprintf("%s/%s/records", domainPath, domain), domainRecordReq)
if err != nil {
return nil, err
}
record := new(domainRecordBase)
if err = d.client.DoWithContext(ctx, req, record); err != nil {
return nil, err
}
return record.Record, nil
}
// Get record from a domain
func (d *DomainRecordsServiceHandler) Get(ctx context.Context, domain, recordID string) (*DomainRecord, error) {
req, err := d.client.NewRequest(ctx, http.MethodGet, fmt.Sprintf("%s/%s/records/%s", domainPath, domain, recordID), nil)
if err != nil {
return nil, err
}
record := new(domainRecordBase)
if err = d.client.DoWithContext(ctx, req, record); err != nil {
return nil, err
}
return record.Record, nil
}
// Update will update a Domain record
func (d *DomainRecordsServiceHandler) Update(ctx context.Context, domain, recordID string, domainRecordReq *DomainRecordReq) error {
req, err := d.client.NewRequest(ctx, http.MethodPatch, fmt.Sprintf("%s/%s/records/%s", domainPath, domain, recordID), domainRecordReq)
if err != nil {
return err
}
return d.client.DoWithContext(ctx, req, nil)
}
// Delete will delete a domain name and all associated records.
func (d *DomainRecordsServiceHandler) Delete(ctx context.Context, domain, recordID string) error {
req, err := d.client.NewRequest(ctx, http.MethodDelete, fmt.Sprintf("%s/%s/records/%s", domainPath, domain, recordID), nil)
if err != nil {
return err
}
return d.client.DoWithContext(ctx, req, nil)
}
// List will list all the records associated with a particular domain on Vultr.
func (d *DomainRecordsServiceHandler) List(ctx context.Context, domain string, options *ListOptions) ([]DomainRecord, *Meta, error) {
req, err := d.client.NewRequest(ctx, http.MethodGet, fmt.Sprintf("%s/%s/records", domainPath, domain), nil)
if err != nil {
return nil, nil, err
}
newValues, err := query.Values(options)
if err != nil {
return nil, nil, err
}
req.URL.RawQuery = newValues.Encode()
records := new(domainRecordsBase)
if err = d.client.DoWithContext(ctx, req, records); err != nil {
return nil, nil, err
}
return records.Records, records.Meta, nil
}
|