gandi is a collection of command line tools for interacting with the gandi.net API.
It currently consist of the following tools: gandi-contact
gandi-operation
gandi-domain
gandi-domain-zone
gandi-domain-zone-record
and gandi-domain-zone-version
. Included is also a wrapper tool gandi
which can be
used instead of each tool separately (i.e gandi zone list
will execute gandi-domain-zone list
).
None, binaries are statically linked. If you want to compile from source you need the go toolchain
- Save all binaries to a location in your PATH (i.e.
/usr/local/bin/
)
- gandi-1.0.3-darwin-386.tar.gz
- gandi-1.0.3-darwin-amd64.tar.gz
- gandi-1.0.3-freebsd-386.tar.gz
- gandi-1.0.3-freebsd-amd64.tar.gz
- gandi-1.0.3-linux-386.tar.gz
- gandi-1.0.3-linux-amd64.tar.gz
- gandi-1.0.3-linux-arm.tar.gz
- gandi-1.0.3-linux-arm5.tar.gz
- gandi-1.0.3-windows-386.tar.gz
- gandi-1.0.3-windows-amd64.tar.gz
The first time one of the tools are executed it will prompt for your gandi API keys which can be found here. The API keys is by default stored in $HOME/.gandi/config (can be overridden with the -c flag).
All examples are run against the test platform (OT&E). Remove the --testing flag to perform queries against the production API.
$ gandi contact --testing info
Firstname: John
Lastname: Doe
Email: john.doe@gmail.com
Address: Foobarstreet 32
Zipcode: 1337
City: Foo City
Country: FB
Phone: +1.555-0122
ContactType: 0
Handle: JD1337-GANDI
$ gandi domain --testing available --domain bazqux.com
Status: available
$ gandi domain --testing create --domain bazqux.com --contact JD1337-GANDI --years 1
DateCreated: 2013-01-27 23:44:10 +0000 UTC
DateStart: 0001-01-01 00:00:00 +0000 UTC
DateUpdated: 2013-01-27 23:44:10 +0000 UTC
Id: 19784
SessionId: 8101
Source: JD1337-GANDI
Step: BILL
Type: domain_create
Params:
auth_id: 8101
tech: JD1337-GANDI
duration: 1
admin: JD1337-GANDI
tld: com
domain: bazqux.com
owner: JD1337-GANDI
param_type: domain
ns: [a.dns.gandi-ote.net b.dns.gandi-ote.net c.dns.gandi-ote.net]
remote_addr: 1.2.3.4
bill: JD1337-GANDI
OperationDetails:
Label: bazqux.com
ProductAction: create
ProductName: com
ProductType: domain
Quantity: 0
$ gandi zone --testing create --name bazqux.com
DateUpdated: 2013-01-27 23:46:57 +0000 UTC
Id: 681917
Name: bazqux.com
Public: false
Version: 1
Domains: 0
Owner: JD1337-GANDI
Versions: 1
$ gandi version --testing new --zone 681917
Created version 2
$ gandi record --testing add --zone 681917 --version 2 --name foo --type A --value 10.0.0.100 --ttl 3600
Id: 3566725
Name: foo
Ttl: 3600
Type: A
Value: 10.0.0.100
$ gandi record --testing add --zone 681917 --version 2 --name foo --type AAAA --value 2001:0db8:85a3:0000:0000:8a2e:0370:7334 --ttl 3600
Id: 3566726
Name: foo
Ttl: 3600
Type: AAAA
Value: 2001:db8:85a3::8a2e:370:7334
$ gandi record --testing add --zone 681917 --version 2 --name foobar --type CNAME --value foobar.com. --ttl 3600
Id: 3566727
Name: foobar
Ttl: 3600
Type: CNAME
Value: foobar.com.
$ gandi version --testing set --zone 681917 --version 2
OK: True
$ gandi record --testing list --zone 681917
Id Name TTL Type Value
3566725 foo 3600 A 10.0.0.100
3566726 foo 3600 AAAA 2001:db8:85a3::8a2e:370:7334
3566727 foobar 3600 CNAME foobar.com.
$ gandi zone --testing set --zone 681917 --domain bazqux.com
AuthInfo: ******
DateCreated: 2013-01-27 23:44:26 +0000 UTC
DateRegistryCreation: 2013-01-27 22:44:25 +0000 UTC
DateRegistryEnd: 2014-01-27 22:44:25 +0000 UTC
DateUpdated: 2013-01-27 23:44:26 +0000 UTC
Fqdn: bazqux.com
Id: 2997
Status: clientTransferProhibited
Tld: com
DateDelete: 2014-02-26 12:44:25 +0000 UTC
DateHoldBegin: 2014-01-27 22:44:25 +0000 UTC
DateHoldEnd: 2014-02-26 22:44:25 +0000 UTC
DatePendingDeleteEnd: 2014-04-02 22:44:25 +0000 UTC
DateRenewBegin: 2012-01-01 00:00:00 +0000 UTC
DateRestoreEnd: 2014-03-28 22:44:25 +0000 UTC
Nameservers: a.dns.gandi-ote.net, b.dns.gandi-ote.net, c.dns.gandi-ote.net
Services: gandidns
ZoneId: 681917
Autorenew:
Active: false
Id: 0
ProductId: 0
ProductTypeId: 0
Contacts:
Admin:
Handle: JD1337-GANDI
Id: 1337
Bill:
Handle: JD1337-GANDI
Id: 1337
Owner:
Handle: JD1337-GANDI
Id: 1337
Reseller:
Id: 0
Tech:
Handle: JD1337-GANDI
Id: 1337