https://github.com/bloq/awdns
Command line DNS admin tool for AWS
https://github.com/bloq/awdns
aws aws-route53 dns node-js
Last synced: about 1 month ago
JSON representation
Command line DNS admin tool for AWS
- Host: GitHub
- URL: https://github.com/bloq/awdns
- Owner: bloq
- License: mit
- Created: 2020-07-17T13:20:45.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2020-09-13T02:38:20.000Z (over 4 years ago)
- Last Synced: 2025-03-02T17:39:08.684Z (about 2 months ago)
- Topics: aws, aws-route53, dns, node-js
- Language: JavaScript
- Homepage:
- Size: 32.2 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# awdns - Command line DNS admin tool for AWS
Create, update and delete DNS records and zones hosted at AWS.
## Motivation
AWS console and official CLI are both powerful, yet complicated. awdns
is a simple CLI tool to ease the burden of administering Route53 DNS
domains for the most popular DNS records (A, AAAA).
## Features
* List all zones
* List all records in a zone
* Add a record to a zone
* Delete records from a zone
* Terse Unix responses (default) or verbose JSON responses.
## Examples
List all zones in the AWS account.
```sh
awdns zones
```
List all zones in the AWS account, with JSON output.
```sh
awdns --verbose zones
```
List all records associated with a single zone, in a BIND-like format.
```sh
awdns ls example.com
```
Add a new record, to a pre-existing zone in the AWS account.
```sh
awdns add foo4.example.com 127.0.0.1
```
Delete *all* records matching NAME, from a pre-existing zone in the AWS account.
```sh
awdns del foo4.example.com
```
## Usage
AWS authentication is handled via the AWS JavaScript SDK.
See [Setting Credentials in Node.js](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-credentials-node.html) for details.
Full usage documentation via `--help` on the command line:
```console
$ awdns --help
Usage: awdns [options] [command]
Options:
-V, --version output the version number
--ttl Specify TTL for new records (default: 300)
--verbose Enable verbose responses
-h, --help display help for command
Commands:
add
Add A or AAAA record to zone
del Delete all RRs from a zone with given FQDN
ls List all records for zone
zones List all zones
help [command] display help for command
```
## Installation
```sh
npm install --global awdns
```