@firstdorsal/powerdns-api

Modules

powerdns-api

Typedefs

Search : object

Records : Array.<Record>

Record : object

powerdns-api

• powerdns-api
  • .PowerdnsClient
    • new module.exports.PowerdnsClient(baseurl, apikey)
    • .getZones() ⇒ Array
    • .getZoneWithMeta(zoneName) ⇒ object
    • .getZone(zoneName) ⇒ object
    • .setRecords(records) ⇒ boolean
    • .deleteRecords(records) ⇒ boolean
    • .search(search) ⇒ object
    • .appendRecord(record) ⇒ boolean

powerdns-api.PowerdnsClient

Class representing the powerdns client

Kind: static class of powerdns-api

• .PowerdnsClient
  • new module.exports.PowerdnsClient(baseurl, apikey)
  • .getZones() ⇒ Array
  • .getZoneWithMeta(zoneName) ⇒ object
  • .getZone(zoneName) ⇒ object
  • .setRecords(records) ⇒ boolean
  • .deleteRecords(records) ⇒ boolean
  • .search(search) ⇒ object
  • .appendRecord(record) ⇒ boolean

new module.exports.PowerdnsClient(baseurl, apikey)

Create a powerdns client.

Param	Type	Description
baseurl	string	The base url where the api can be found
apikey	string	The api key for the powerdns endpoint

Example

(async () => {
    require('dotenv').config();

    const {
        Powerdns
    } = require('powerdns-api');

    const pdns = new Powerdns(process.env.PDNS_API_ENDPOINT, process.env.PDNS_API_KEY);

    console.log(await pdns.getZone('example.com'));
})();

powerdnsClient.getZones() ⇒ Array

Returns array of zones on pdns server.

Kind: instance method of PowerdnsClient Returns: Array - - array of zones on the server Example

await pdns.getZones();

powerdnsClient.getZoneWithMeta(zoneName) ⇒ object

Returns single zone with meta information.

Kind: instance method of PowerdnsClient Returns: object - - the zone with meta information

Param	Type	Description
zoneName	string	takes a domain name

Example

await pdns.getZoneWithMeta();

powerdnsClient.getZone(zoneName) ⇒ object

Returns array with rrsets.

Kind: instance method of PowerdnsClient Returns: object - - just the rrsets of the zone

Param	Type	Description
zoneName	string	takes a domain name

Example

await pdns.getZone('example.com');

powerdnsClient.setRecords(records) ⇒ boolean

Takes records as array and sets them. If records exist it replaces them.

Kind: instance method of PowerdnsClient Returns: boolean - - boolean indicating the success of the operation

Param	Type	Description
records	Records	array containing the records

Example

await pdns.setRecords([{
           name: "example.com",
           type: "A",
           ttl: 300,
           content: ['1.1.1.1']
       }]);

powerdnsClient.deleteRecords(records) ⇒ boolean

Takes records as array and deletes them.

Kind: instance method of PowerdnsClient Returns: boolean - - boolean indicating the success of the operation

Param	Type	Description
records	Records	array containing the records to be deleted

Example

await pdns.deleteRecords([{
           name: "example.com",
           type: "A"
       }]);

powerdnsClient.search(search) ⇒ object

takes object with query as string; searches for elements in pdns server; returns found elements as array; if max is not specified it defaults to 10 returned records; if object_type is not defined it defaults to the type "record"; must be awaited;

Kind: instance method of PowerdnsClient Returns: object - - search results

Param	Type	Description
search	Search	object with the query paramter

Example

await pdns.search({
           query: 'example.com',
           max: 100,
           object_type: "zone"
       });

powerdnsClient.appendRecord(record) ⇒ boolean

Takes ONE record as object and appends it not replacing other records with the same name.

Kind: instance method of PowerdnsClient Returns: boolean - - boolean indicating the success of the operation

Param	Type	Description
record	Record	array containing the records to be deleted

Example

await pdns.appendRecord({
           name: "example.com",
           type: "A",
           ttl: 300,
           content: ['1.1.1.1','2.2.2.2']
       });

Search : object

Kind: global typedef Properties

Name	Type	Default	Description
query	string		query to search for
[max]	number	10	limits the ammount of returned values
[object_type]	string	"record"	for what kind of pdns object to search

Example

{query: 'example.com', max: 100, object_type: "zone"}

Records : Array.<Record>

Kind: global typedef Example

[{
    name: "example.com",
    type: "A",
    ttl: 300,
    content: ['1.1.1.1', '8.8.8.8']
}, {
    name: "*.example.com",
    type: "A",
    ttl: 300,
    content: ['1.1.1.1', '8.8.8.8']
}]

Record : object

Kind: global typedef Properties

Name	Type	Description
name	string	key name of the record
type	string	type of the record
ttl	number	time to live of the record
content	Array	value array with content of the record

Example

{name: "example.com", type: "A", ttl: 300, content: ['1.1.1.1', '8.8.8.8']}