Skip to content

README.rdoc

Latest commit

 

History

History
58 lines (33 loc) · 1.5 KB

README.rdoc

File metadata and controls

58 lines (33 loc) · 1.5 KB
Raw

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.