www.collazo.ws » linux

Using Rackspace DNSaaS with curl (part 1)

robert — Fri, 08 Jul 2011 20:35:02 +0000

With the release of Rackspace DNSaaS (blog post here), I thought I would put together some examples of using curl with the service. With this release, you now have programmatic access to DNS via the API where you can set TTLs, create and delete various record types, and create and delete domains.

Authentication

First, you’ll have to authenticate. To do this, you will need your API key and username.

$ curl -D – -H "X-Auth-Key: yourAPIKey" -H "X-Auth-User: yourUsername" https://auth.api.rackspacecloud.com/v1.0

You should receive the following response:

HTTP/1.1 204 No Content
Server: Apache/2.2.3 (Mosso Engineering)
X-Storage-Url: https://storage101.dfw1.clouddrive.com/v1/yourAccountHash
Content-Type: application/octet-stream
Date: Date and Time
X-Auth-Token: yourAuthToken
X-Storage-Token: yourStorageToken
X-Server-Management-Url: https://servers.api.rackspacecloud.com/v1.0/yourAccountNumber
Connection: Keep-Alive
X-CDN-Management-Url: https://cdn1.clouddrive.com/v1/yourAccountHash
Content-Length: 0

Listing Domain Information

To see a list of your current domains, run the following command. Don’t forget to replace your auth token and account number.

$ curl -X GET -H "X-Auth-Token: yourAuthToken" -H "Accept: application/xml" https://dns.api.rackspacecloud.com/v1.0/yourAccountNumber/domains

Your output will be XML formatted and look like:

To see the same thing formatted as JSON output, run the following:

$ curl -X GET -H "X-Auth-Token: yourAuthToken" -H "Accept: application/json" https://dns.api.rackspacecloud.com/v1.0/yourAccountNumber/domains

{
   "domains":[
      {
         "name":"collazo.ws",
         "id":1697941,
         "accountId":yourAccountNumber,
         "updated":"2011-06-28T04:18:17.000+0000",
         "created":"2009-12-11T01:01:26.000+0000"
      },
      {
         "name":"deployitron.com",
         "id":4062964,
         "accountId":yourAccountNumber,
         "updated":"2011-03-19T08:10:31.000+0000",
         "created":"2011-01-21T23:24:44.000+0000"
      }
   ],
   "totalEntries":2
}

To get details about a particular domain, you’ll enter the following:

$ curl -X GET -H "X-Auth-Token: yourAuthToken" -H "Accept: application/xml" https://dns.api.rackspacecloud.com/v1.0/yourAccountNumber/domains/4062964 # <- make sure you replace this with your domain ID

This will output the following in XML format:

To get the same thing JSON formatted:

$ curl -X GET -H "X-Auth-Token: yourAuthToken" -H "Accept: application/json" https://dns.api.rackspacecloud.com/v1.0/yourAccountNumber/domains/4062964

{
   "name":"deployitron.com",
   "id":4062964,
   "accountId":yourAccountNumber,
   "nameservers":[
      {
         "name":"ns.rackspace.com"
      },
      {
         "name":"ns1.rackspace.com"
      }
   ],
   "updated":"2011-03-19T08:10:31.000+0000",
   "ttl":3600,
   "recordsList":{
      "records":[
         {
            "name":"deployitron.com",
            "id":"A-1234567",
            "type":"A",
            "data":"174.143.174.233",
            "updated":"2011-01-22T11:28:10.000+0000",
            "ttl":3600,
            "created":"2011-01-22T11:28:10.000+0000"
         },
         {
            "name":"deployitron.com",
            "id":"NS-2345678",
            "type":"NS",
            "data":"dns1.stabletransit.com",
            "updated":"2011-01-21T23:24:44.000+0000",
            "ttl":3600,
            "created":"2011-01-21T23:24:44.000+0000"
         },
         {
            "name":"deployitron.com",
            "id":"NS-2345680",
            "type":"NS",
            "data":"dns2.stabletransit.com",
            "updated":"2011-01-21T23:24:44.000+0000",
            "ttl":3600,
            "created":"2011-01-21T23:24:44.000+0000"
         },
         {
            "name":"www.deployitron.com",
            "id":"CNAME-4567890",
            "type":"CNAME",
            "data":"deployitron.com",
            "updated":"2011-01-22T11:30:35.000+0000",
            "ttl":3600,
            "created":"2011-01-22T11:30:35.000+0000"
         },
         {
            "name":"www2.deployitron.com",
            "id":"CNAME-5678901",
            "type":"CNAME",
            "data":"deployitron.com",
            "updated":"2011-03-19T08:10:31.000+0000",
            "ttl":600,
            "created":"2011-03-19T08:10:31.000+0000"
         }
      ],
      "totalEntries":5
   },
   "emailAddress":"ipadmin@stabletransit.com",
   "created":"2011-01-21T23:24:44.000+0000"
}

Creating Domains

To create a domain, we issue the following JSON formatted command:

$ curl -D – -X POST -d '{ "domains":[ { "name":"aeVo8AiHeesh.ws", "emailAddress":"robert@aeVo8AiHeesh.ws", "comment":"This is the first domain created via API", "recordsList": { "records":[ { "ttl":600, "data":"127.0.0.1", "name":"aeVo8AiHeesh.ws", "type":"A" },{ "priority": 10, "ttl":86400, "data":"mail.aeVo8AiHeesh.ws", "name":"aeVo8AiHeesh.ws", "type":"MX" },{ "ttl":300, "data":"v=spf1 mx -all", "name":"aeVo8AiHeesh.ws", "type":"TXT" } ] } } ] }' -H "X-Auth-Token: yourAuthToken" -H "Content-Type: application/json" https://dns.api.rackspacecloud.com/v1.0/yourAccountNumber/domains

And the following is returned:

HTTP/1.1 202 Accepted
X-API-VERSION: 1.0.8
Content-Type: application/json
Date: Fri, 08 Jul 2011 15:18:12 GMT
Content-Length: 155
Server: Jetty(7.3.1.v20110307)

{"jobId":"yourJobID","callbackUrl":"https://dns.api.rackspacecloud.com/v1.0/yourAccountNumber/status/yourJobID"}

It’s important to note your job ID so that you can check the status of your job by issuing the following command:

$ curl -X GET -H "X-Auth-Token: yourAuthToken" -H "Accept: application/json" https://dns.api.rackspacecloud.com/v1.0/yourAccountNumber/status/yourJobID

If your job completed successfully, you should see something similar to the following:

{"domains":[{"name":"aevo8aiheesh.ws","id":2841222,"comment":"This is the first domain created via API","accountId":yourAccountNumber,"nameservers":[{"name":"ns.rackspace.com"},{"name":"ns1.rackspace.com"}],"updated":"2011-07-08T15:21:46.000+0000","ttl":3600,"recordsList":{"records":[{"name":"aevo8aiheesh.ws","id":"A-7088731","type":"A","data":"127.0.0.1","updated":"2011-07-08T15:21:47.000+0000","ttl":600,"created":"2011-07-08T15:21:47.000+0000"},{"name":"aevo8aiheesh.ws","id":"MX-3272903","priority":10,"type":"MX","data":"mail.aeVo8AiHeesh.ws","updated":"2011-07-08T15:21:48.000+0000","ttl":86400,"created":"2011-07-08T15:21:48.000+0000"},{"name":"aevo8aiheesh.ws","id":"TXT-243256","type":"TXT","data":"v=spf1 mx -all","updated":"2011-07-08T15:21:49.000+0000","ttl":300,"created":"2011-07-08T15:21:49.000+0000"}]},"emailAddress":"robert@aeVo8AiHeesh.ws","created":"2011-07-08T15:21:45.000+0000"}]}

I see that it was created and I can verify via dig by running:

$ dig aevo8aiheesh.ws @ns.rackspace.com any

Which returns:

; <<>> DiG 9.6.0-APPLE-P2 <<>> aevo8aiheesh.ws @ns.rackspace.com any
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 40475
;; flags: qr aa rd; QUERY: 1, ANSWER: 6, AUTHORITY: 0, ADDITIONAL: 2
;; WARNING: recursion requested but not available

;; QUESTION SECTION:
;aevo8aiheesh.ws.               IN      ANY

;; ANSWER SECTION:
aevo8aiheesh.ws.        3600    IN      SOA     ns1.rackspace.com. robert.aevo8aiheesh.ws. 1310138509 3600 3600 3600 3600
aevo8aiheesh.ws.        86400   IN      MX      10 mail.aevo8aiheesh.ws.
aevo8aiheesh.ws.        3600    IN      NS      dns1.stabletransit.com.
aevo8aiheesh.ws.        3600    IN      NS      dns2.stabletransit.com.
aevo8aiheesh.ws.        300     IN      TXT     "v=spf1 mx -all"
aevo8aiheesh.ws.        600     IN      A       127.0.0.1

;; ADDITIONAL SECTION:
dns1.stabletransit.com. 86400   IN      A       69.20.95.4
dns2.stabletransit.com. 86400   IN      A       65.61.188.4

;; Query time: 35 msec
;; SERVER: 69.20.95.4#53(69.20.95.4)
;; WHEN: Fri Jul  8 10:45:38 2011
;; MSG SIZE  rcvd: 241

We can accomplish the same thing via XML by running the following:

$ curl -D - -X POST -d '' -H "X-Auth-Token: yourAuthToken" -H "Content-Type: application/xml" https://dns.api.rackspacecloud.com/v1.0/yourAccountID/domains

Which outputs:

HTTP/1.1 202 Accepted
X-API-VERSION: 1.0.8
Content-Type: application/json
Date: Fri, 08 Jul 2011 19:35:22 GMT
Content-Length: 155
Server: Jetty(7.3.1.v20110307)

{"jobId":"yourJobID","callbackUrl":"https://dns.api.rackspacecloud.com/v1.0/yourAccountNumber/status/yourJobID"}

Checking the status:

$ curl -X GET -H "X-Auth-Token: yourAuthToken" -H "Accept: application/xml" https://dns.api.rackspacecloud.com/v1.0/yourAccountID/status/yourJobID

Which returns:

To verify the domain exists via dig:

$ dig paingeez7uec.com @ns.rackspace.com any

Which outputs:

; <<>> DiG 9.6.0-APPLE-P2 <<>> paingeez7uec.com @ns.rackspace.com any
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 45478
;; flags: qr aa rd; QUERY: 1, ANSWER: 6, AUTHORITY: 0, ADDITIONAL: 2
;; WARNING: recursion requested but not available

;; QUESTION SECTION:
;paingeez7uec.com.              IN      ANY

;; ANSWER SECTION:
paingeez7uec.com.       5600    IN      SOA     ns1.rackspace.com. robert.paingeez7uec.com. 1310153726 5600 5600 5600 5600
paingeez7uec.com.       5000    IN      MX      10 mail.paingeez7uec.com.
paingeez7uec.com.       5600    IN      NS      dns1.stabletransit.com.
paingeez7uec.com.       5600    IN      NS      dns2.stabletransit.com.
paingeez7uec.com.       600     IN      TXT     "v=spf1 mx -all"
paingeez7uec.com.       5600    IN      A       127.0.0.1

;; ADDITIONAL SECTION:
dns1.stabletransit.com. 86400   IN      A       69.20.95.4
dns2.stabletransit.com. 86400   IN      A       65.61.188.4

;; Query time: 42 msec
;; SERVER: 69.20.95.4#53(69.20.95.4)
;; WHEN: Fri Jul  8 14:49:55 2011
;; MSG SIZE  rcvd: 239

Now you can create domains in using both JSON and XML formatted responses.

Deleting Domains

To delete a domain using curl follow these simple steps. You will need your account ID (yourAccountID in previous examples) and the domain ID from a domain list.

JSON:

$ curl -X DELETE -H "X-Auth-Token: yourAuthToken" -H "Accept: application/json" https://dns.api.rackspacecloud.com/v1.0/yourAccountID/domains/2841222

{"jobId":"yourJobID","callbackUrl":"https://dns.api.rackspacecloud.com/v1.0/yourAccountID/status/yourJobID"}

XML:

$ curl -X DELETE -H "X-Auth-Token: yourAuthToken" -H "Accept: application/xml" https://dns.api.rackspacecloud.com/v1.0/yourAccountID/domains/2841642

yourJobIDhttps://dns.api.rackspacecloud.com/v1.0/yourAccountID/status/yourJobID

Stay tuned for part 2 where I will show how to modify domains, and add/delete/modify records.

Edge Purge Content from Rackspace Cloud Files via curl

robert — Wed, 29 Jun 2011 21:10:16 +0000

When the Rackspace Cloud Files product received Edge Purge functionality via the API, I didn’t give it much thought as I didn’t use the CDN functionality for any of my personal projects. That changed recently and I started doing some work with the CDN (powered by Akamai). All was fine until I realized I had set the TTL for the objects too high for my testing and wasn’t receiving the right content. Below you’ll find the appropriate methods for doing an edge purge of an object and container via curl using the API.

First, you’ll need to authenticate using your API key and username.

$ curl -D – -H "X-Auth-Key: yourAPIkey" -H "X-Auth-User: yourUsername" https://auth.api.rackspacecloud.com/v1.0

You should receive the following:

HTTP/1.1 204 No Content
Server: Apache/2.2.13 (Red Hat)
X-Storage-Url: https://storage.clouddrive.com/v1/yourAccountHash
Content-Type: application/octet-stream
Date: Date & Time
X-Auth-Token: yourAuthToken
X-Storage-Token: yourStorageToken
X-Server-Management-Url: https://servers.api.rackspacecloud.com/v1.0/yourAccountNumber
Connection: Keep-Alive
X-CDN-Management-Url: https://cdn1.clouddrive.com/v1/yourAccountHash
Content-Length: 0

You now have the information you need to do the Edge Purge from the Akamai fronted CDN. To delete an object, you’ll need the “X-Auth-Token” and “X-CDN-Management-Url”.

To do an Edge Purge of the given object “foo.txt” in the container “bar”, send the following via curl:

$ curl -D – -X DELETE -H "X-Auth-Token: yourAuthToken" -H "X-Purge-Email: your@email.address" https://cdn1.clouddrive.com/v1/yourAccountHash/bar/foo.txt

You’ll receive the following in response as well as an email to your@email.address.

HTTP/1.1 204 No Content
Date: Date & Time
Server: Apache
X-Akam-Est-Time: 420
X-Akam-Result-Code: 100
Content-Length: 0
Connection: close
Content-Type: text/plain; charset=UTF-8

To do an Edge Purge of the container “bar”, send the following via curl:

curl -D – -H "X-Auth-Token: yourAuthToken" -H "X-Purge-Email: your@email.address" -X DELETE https://cdn1.clouddrive.com/v1/yourAccountHash/bar/

You should receive a response identical to the one you did for object Edge Purge.

That’s it!

Palm Pre impressions

robert — Mon, 29 Jun 2009 13:19:55 +0000

Disclaimer: I’m a Palm fanboy. I’ve had a Palm device in some form or fashion since the Palm OS 3.0 days. I think that I could still probably write in Graffiti if I needed to. It all started with a Handspring Visor Deluxe, upgraded into the Handspring Visor Edge, morphed into the Palm Treo 650 and finally my last PDA, the Palm Centro. Occasionally I would dip into the Microsoft WindowsCE, Pocket PC and Windows Mobile worlds but I always went back to my trusty Handspring or Palm devices. I even have carried a Blackberry simultaneously for work because I didn’t want to give up the features my Palm devices gave me. In addition to being a Palm enthusiast, I’m also a big fan of all things Apple. I have a first generation Mac Pro (dual dual-core Xeon), a Macbook (courtesy of my employer), and various iPod flavors. I’m also a Linux systems administrator (Gentoo, Red Hat, Fedora, Ubuntu, and Debian). With that said, here’s a somewhat biased review of the new Palm Pre.

I really like the Palm Pre. Even the service plan from Sprint. While Sprint isn’t my favorite provider, they have been much better from a service perspective than anytime I have had to deal with ATT. Everything you’ve read is true. It’s missing some features (not copy & paste but almost). There aren’t many things you can’t do with this phone.

Things I like

USB Modes

When you plug your Palm Pre into your Mac, you will be presented with three options: Media Sync, USB Drive, and Just Charge. While the phone is in Media Sync or USB Drive mode, you can not make or receive calls or text messages. When I plugged the phone into my Macbook and selected Media Sync or USB Drive, I was presented with a Finder window that looked like:

A view of the Finder window when Media Sync mode is selected.

The only difference between Media Sync and USB Drive modes (as far as I can tell on my Mac machines) is that when Media Sync mode is selected, iTunes starts and the icon looks likes it does when my iPod is plugged in. In USB Drive mode, iPhoto starts and the device looks like a generic mass storage device. Otherwise, the Finder view is the same. In Just Charge mode, the Pre does just that and nothing shows up on my Mac.

The Linux Connection

You’ll notice that the Finder window shows a PDF named “Open Source Information.pdf”. This PDF has copies of the Gnu Public License (GPL) v2, LGPL v2.1, Apache License, Prototype JavaScript Framework, Flex, Bzip2, Openssl, Curl, SSLeay, Libpcap, Fontconfig, libxml2, Bitstream Vera Fonts, Uriparser, Giflib, Ksoap, Poly9’s polyvalent URLParser class, Wbxml.java , Wbxmlparser.java , and WbxmlSerializer.java, Liboil, stlport, Sudo, Icu, Dhcp-client, NTP, PPP, Licence (sic) for libxslt except libexslt, jpeg-6b, Expat, c-ares, Freetype, Putty, Dropbear, Ncurses, Md5, Libpng, Strace, zlib, Datejs, libspeex, speex, Ncurses, Cairo, Prototype JavaScript framework, libunwind, Wpa_supplicant, Pmipclib, tiff, JSON-C, AGG, JSON, The Legion Of The Bouncy Castle, script.aculo.us, Jemalloc, Npruntime.h, The wxWindows Library Licence, dbus (Academic Free License 2.1), Host AP, File-backed USB Storage Gadget, SQLiteJDBC, libvorbis, libogg, VLGothic Proportional Japanese Font, Minifier, CJK Unicode TrueType Fonts, and last, but not least the JArgs command line option parsing suite for Java licenses.

What does all that license info mean? It means that the Pre is built using open source software on a Linux platform. Knowing that, some people have taken to exploring the phone and doing things that are not supported out of the box.

Camera

Another feature this phone has going for it is the 3 megapixel camera. It has a nice built-in flash that takes decent pictures. The camera lacks a couple of features like digital zoom and video recording which my Centro had. I don’t really miss the zoom but the video recording would be nice to have although the ultra bright flash almost makes up for it.

Keyboard

One of the reasons I never purchased an iPhone was the lack of a “real” keyboard. I tried out the onscreen keyboard and just couldn’t get used to the fact that there was no tactile feedback. While not perfect, the Pre has a usable keyboard and if you are upgrading from a Centro, it will be no problem for you. My only complaint on the keyboard is that Palm moved a few of the buttons around from where they were located on the Centro.

Multitasking

If there is one thing I really love about this phone, it’s the true multitasking capabilities. I’ve been listening to Pandora while browsing the web and tweeting via Tweed. I can open up Google Maps and switch over to a contact’s card to check the address without having to close one or the other. It does this via “cards” which are the application windows and the center button at the bottom of the phone. Press the button once and you can see all of the running applications (think alt-tab). Press it again and it brings you back to the last application you were using. When you want to close an application, press the center button and swipe the card up. The application is closed. In addition to the cards, there is a notification bar for other applications that are running periodically like email which notifies you at the bottom of the screen when you have new mail (or new tweets).

3 applications running simultaneously

Things I don’t like

Battery life

You have probably read about this issue in other places but battery life for the Pre stinks. Palm has addressed this in their 1.0.3 update but I did not find any significant improvements. There are some sites that you can visit for tips on how to maximize your Pre’s battery life. Some of the suggestions I found most beneficial were setting the screen to turn off automatically after a shorter period of inactivity, lowering the screen brightness, and turning off the Wi-Fi, Bluetooth and GPS features when not using them. If you do not want to make these changes, Seidio makes a battery that offers more charging capability (yes, the Palm Pre has a replaceable battery).

Copy & Paste

Yes, the Palm Pre has copy and paste. Does it work? Kinda. You can’t copy and paste from text messages, IM’s, web pages but you can copy and paste from URL bar, address book and text messages (as you type them). In my Centro, you could copy and paste from everything.

Download from the browser

You can’t download from the browser on the Pre. That means no saving mp3′s or images to your phone (yet another thing I could do on my Centro). I don’t know why Palm removed these features but hopefully they’ll give them back in a future update.

Notification sounds can’t be changed

Yes, that’s right, you can not have different notification sounds for different events. A new tweet sounds like a new email which sounds like a new voicemail (minus the initial ringing of course). Hopefully Palm will release an update that will allow this to be modified but until then, you can always try to change it yourself.

Classic emulation

Being a long time Palm user, I was really excited that I would be able to use my old Garnet applications on my new webOS phone. Unfortunately, I was never able to get Classic from MotionApps to work and now my trial period is over. I can’t see myself spending $29.95 on an application that I’m not even sure will run my applications. I have a ticket open with them to see if they can expand my trial so we’ll see where that goes.

App Catalog

While there are some great applications in the App Catalog (Fandango, Accuweather, Tweed), it just doesn’t have the quantity that the iPhone has. Granted, the iPhone has been around for a few years but Palm hasn’t even released the SDK (codenamed Mojo) publicly yet. I understand the need to test but how could this have not been ready in time for launch? On the plus side, it’s very easy to use and install applications.

Conclusion

Get this phone. I don’t think you’ll be disappointed. Here is a link detailing some cost comparisons too and you’ll see that Sprint is cheaper for unlimited everything.