Ruby library and command line client for the Dynect REST API
Ruby
Switch branches/tags
Nothing to show
Latest commit e00b028 Jun 5, 2015 @mconigliaro mconigliaro Merge pull request #3 from atrepca/master
Add logging to file

README.rdoc

dynect4r

dynect4r is a Ruby library and command line client for the Dynect REST API (version 2).

Installation

gem install dynect4r

Using this library in your own project

require 'dynect4r'
client = Dynect::Client.new(:customer_name => 'example',
                            :user_name => 'example',
                            :password => 'example')
response = client.rest_call(:get, 'Zone/example.org')
pp response

Using the built-in command line client

  1. Create a file called .dynect4r containing your Dynect customer name, username and password on one line separated by whitespace. Note that this file is assumed to be in the home directory by default.

  2. See examples below:

General usage

dynect4r-client [options] [rdata][, ...]
  • Multiple sets of rdata can be specified by separating them with commas.

  • Records can be deleted by not specifying rdata.

Examples

Create an A record

dynect4r-client -n test.example.org 1.1.1.1

Create round-robin A records

dynect4r-client -n test.example.org 1.1.1.1,2.2.2.2,3.3.3.3

Create a CNAME record

dynect4r-client -n test.example.org -t CNAME test.example.org.

Create an SRV record

dynect4r-client -n srv.example.org -t SRV 0 10 20 target.example.org.

Help and Troubleshooting

See the –help command line option:

dynect4r-client --help

Use debug logging:

dynect4r-client -v debug

All output is also logged to file: dynect4r.log, by default sitting in the home directory.