Zone

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();
const zone = dns.zone('zone-id');
const change = zone.change('change-id');

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();

const config = {
  dnsName: 'example.com.',
  // ...
};

zone.create(config, (err, zone, apiResponse) => {
  if (!err) {
    // The zone was created successfully.
  }
});

//-
// If the callback is omitted, we'll return a Promise.
//-
zone.create(config).then((data) => {
  const zone = data[0];
  const apiResponse = data[1];
});

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();
const zone = dns.zone('zone-id');

const oldARecord = zone.record('a', {
  name: 'example.com.',
  data: '1.2.3.4',
  ttl: 86400
});

const newARecord = zone.record('a', {
  name: 'example.com.',
  data: '5.6.7.8',
  ttl: 86400
});

const config = {
  add: newARecord,
  delete: oldARecord
};

zone.createChange(config, (err, change, apiResponse) => {
  if (!err) {
    // The change was created successfully.
  }
});

//-
// If the callback is omitted, we'll return a Promise.
//-
zone.createChange(config).then((data) => {
  const change = data[0];
  const apiResponse = data[1];
});

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();
const zone = dns.zone('zone-id');

zone.delete((err, apiResponse) => {
  if (!err) {
    // The zone is now deleted.
  }
});

//-
// Use `force` to first empty the zone before deleting it.
//-
zone.delete({
  force: true
}, (err, apiResponse) => {
  if (!err) {
    // The zone is now deleted.
  }
});

//-
// If the callback is omitted, we'll return a Promise.
//-
zone.delete().then(data => {
  const apiResponse = data[0];
});

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();
const zone = dns.zone('zone-id');

const oldARecord = zone.record('a', {
  name: 'example.com.',
  data: '1.2.3.4',
  ttl: 86400
});

const callback = (err, change, apiResponse) => {
  if (!err) {
    // Delete change modification was created.
  }
};

zone.deleteRecords(oldARecord, callback);

//-
// Delete multiple records at once.
//-
const oldNs1Record = zone.record('ns', {
  name: 'example.com.',
  data: 'ns-cloud1.googledomains.com.',
  ttl: 86400
});

const oldNs2Record = zone.record('ns', {
  name: 'example.com.',
  data: 'ns-cloud2.googledomains.com.',
  ttl: 86400
});

zone.deleteRecords([
  oldNs1Record,
  oldNs2Record
], callback);

//-
// Possibly a simpler way to perform the above change is deleting records
by
// type.
//-
zone.deleteRecords('ns', callback);

//-
// You can also delete records of multiple types.
//-
zone.deleteRecords(['ns', 'a'], callback);

//-
// If the callback is omitted, we'll return a Promise.
//-
zone.deleteRecords(oldARecord).then((data) => {
  const change = data[0];
  const apiResponse = data[1];
});

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();
const zone = dns.zone('zone-id');

zone.exists((err, exists) => {});

//-
// If the callback is omitted, we'll return a Promise.
//-
zone.exists().then((data) => {
  const exists = data[0];
});

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();
const zone = dns.zone('zone-id');

const zoneFilename = '/Users/stephen/zonefile.zone';

zone.export(zoneFilename, err => {
  if (!err) {
    // The zone file was created successfully.
  }
});

//-
// If the callback is omitted, we'll return a Promise.
//-
zone.export(zoneFilename).then(() => {});

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();
const zone = dns.zone('zone-id');

zone.get((err, zone, apiResponse) => {
  // `zone.metadata` has been populated.
});

//-
// If the callback is omitted, we'll return a Promise.
//-
zone.get().then(data => {
  const zone = data[0];
  const apiResponse = data[1];
});

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();

const callback = (err, changes, nextQuery, apiResponse) => {
  // The `metadata` property is populated for you with the metadata at the
  // time of fetching.
  changes[0].metadata;

  // However, in cases where you are concerned the metadata could have
  // changed, use the `getMetadata` method.
  changes[0].getMetadata((err, metadata) => {});
  if (nextQuery) {
    // nextQuery will be non-null if there are more results.
    zone.getChanges(nextQuery, callback);
  }
};

const zone = dns.zone('zone-id');

zone.getChanges(callback);

//-
// If the callback is omitted, we'll return a Promise.
//-
zone.getChanges().then((data) => {
  const changes = data[0];
});

zone.getChangesStream()
  .on('error', console.error)
  .on('data', change => {
    // change is a Change object.
  })
  .on('end', () => {
    // All changes retrieved.
  });

//-
// If you anticipate many results, you can end a stream early to prevent
// unnecessary processing and API requests.
//-
zone.getChangesStream()
  .on('data', function(change) {
    this.end();
  });

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();
const zone = dns.zone('zone-id');

zone.getMetadata((err, metadata, apiResponse) => {});

//-
// If the callback is omitted, we'll return a Promise.
//-
zone.getMetadata().then((data) => {
  const metadata = data[0];
  const apiResponse = data[1];
});

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();

const callback = (err, records, nextQuery, apiResponse) => {
  if (!err) {
    // records is an array of Record objects.
  }

  if (nextQuery) {
    zone.getRecords(nextQuery, callback);
  }
};

const zone = dns.zone('zone-id');

zone.getRecords(callback);

//-
// Provide a query for further customization.
//-

// Get the namespace records for example.com.
const query = {
  name: 'example.com.',
  type: 'NS'
};

zone.getRecords(query, callback);

//-
// If you only want records of a specific type or types, provide them in
// place of the query object.
//-
zone.getRecords('ns', (err, records) => {
  if (!err) {
    // records is an array of NS Record objects in your zone.
  }
});

//-
// You can also specify multiple record types.
//-
zone.getRecords(['ns', 'a', 'cname'], (err, records) => {
  if (!err) {
    // records is an array of NS, A, and CNAME records in your zone.
  }
});

//-
// If the callback is omitted, we'll return a Promise.
//-
zone.getRecords(query).then(data => {
  const records = data[0];
});

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();
const zone = dns.zone('zone-id');

zone.getRecordsStream()
  .on('error', console.error)
  .on('data', record => {
    // record is a Record object.
  })
  .on('end', () => {
    // All records retrieved.
  });

//-
// If you anticipate many results, you can end a stream early to prevent
// unnecessary processing and API requests.
//-
zone.getRecordsStream()
  .on('data', function(change) {
    this.end();
  });

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();
const zone = dns.zone('zone-id');

const zoneFilename = '/Users/dave/zonefile.zone';

zone.import(zoneFilename, (err, change, apiResponse) => {
  if (!err) {
    // The change was created successfully.
  }
});

//-
// If the callback is omitted, we'll return a Promise.
//-
zone.import(zoneFilename).then(data => {
  const change = data[0];
  const apiResponse = data[1];
});

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();

const zone = dns.zone('zone-id');

//-
// Reference an existing record to delete from your zone.
//-
const oldARecord = zone.record('a', {
  name: 'example.com.',
  data: '1.2.3.4',
  ttl: 86400
});

//-
// Construct a record to add to your zone.
//-
const newARecord = zone.record('a', {
  name: 'example.com.',
  data: '5.6.7.8',
  ttl: 86400
});

//-
// Use these records together to create a change.
//-
zone.createChange({
  add: newARecord,
  delete: oldARecord
}, (err, change, apiResponse) => {});

const {DNS} = require('@google-cloud/dns');
const dns = new DNS();

const zone = dns.zone('zone-id');

const newNs1Record = zone.record('ns', {
  name: 'example.com.',
  data: 'ns-cloud1.googledomains.com.',
  ttl: 86400
});

const newNs2Record = zone.record('ns', {
  name: 'example.com.',
  data: 'ns-cloud2.googledomains.com.',
  ttl: 86400
});

const newNsRecords = [
  newNs1Record,
  newNs2Record
];

zone.replaceRecords('ns', newNsRecords, (err, change, apiResponse) => {
  if (!err) {
    // The change was created successfully.
  }
});

//-
// If the callback is omitted, we'll return a Promise.
//-
zone.replaceRecords('ns', newNsRecords).then(data => {
  const change = data[0];
  const apiResponse = data[1];
});