/vinyldns-cli

A Go-based CLI to vinyldns

Primary LanguageGoApache License 2.0Apache-2.0

Build Status

vinyldns-cli

A Golang-based CLI for the vinyldns DNS as a service API.

Installation

Download the desired pre-compiled executable release version for your operating system.

For example, to install version 0.7.0 on Mac OS:

wget https://github.com/vinyldns/vinyldns-cli/releases/download/v0.7.0/vinyldns_0.7.0_darwin_x86_64

chmod +x vinyldns_0.7.0_darwin_x86_64

./vinyldns_0.7.0_darwin_x86_64 --help

Compiling from Golang source

Alternatively, if you choose to compile from Golang source code:

  • install Golang
  • set up your $GOPATH
  • go get github.com/vinyldns/vinyldns-cli
  • cd $GOPATH/github.com/vinyldns/vinyldns-cli && make

Usage

vinyldns assumes the following environment variables are set:

VINYLDNS_HOST=
VINYLDNS_ACCESS_KEY=
VINYLDNS_SECRET_KEY=

Usage instructions:

vinyldns --help

Supported commands:

COMMANDS:
     groups              groups
     group               group --group-id <groupID>
     group-delete        group-delete --group-id <groupID>
     group-admins        group-admins --group-id <groupID>
     group-members       group-members --group-id <groupID>
     group-activity      group-activity --group-id <groupID>
     zones               zones
     zone                zone --zone-id <zoneID>
     zone-delete         zone-delete --zone-id <zoneID>
     zone-connection     zone-connection --zone-id <zoneID>
     zone-changes        zone-changes --zone-changes <zoneID>
     record-set-changes  record-set-changes --zone-id <zoneID>
     record-set          record-set --zone-id <zoneID> --record-set-id <recordSetID>
     record-set-change   record-set-change --zone-id <zoneID> --record-set-id <recordSetID> --change-id <changeID>
     record-set-create   record-set-create --zone-id <zoneID> --record-set-name <recordSetName> --record-set-type <type> --record-set-ttl <TTL> --record-set-data <rdata>
     record-set-delete   record-set-delete --zone-id <zoneID> --record-set-id <recordSetID>
     record-sets         record-sets --zone-id <zoneID>
     help, h             Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --host value                    vinyldns API Hostname [$VINYLDNS_HOST]
   --access_key value, --ak value  vinyldns access key [$VINYLDNS_ACCESS_KEY]
   --secret_key value, --sk value  vinyldns secret key [$VINYLDNS_SECRET_KEY]
   --help, -h                      show help
   --version, -v                   print the version