dnscontrol/docs/_providers/gandi.md
Vincent Bernat d9db572e3c doc: update documentation for Gandi to mention the LiveDNS provider (#385)
The `GANDI` provider also seems to be unable to see new domains (the
ones bought through the new interface), but I didn't mention that as
it may be a bug that could be solves at some point.
2018-08-03 08:53:30 -04:00

1.3 KiB

name title layout jsId
Gandi Gandi Provider default GANDI

Gandi Provider

There are two providers for Gandi:

  1. GANDI uses the v3 API and is able to act as a registrar provider and a DNS provider. It is not able to handle domains that have migrated to the new LiveDNS API. You need to get the API key from the v4 interface.

  2. GANDI-LIVEDNS uses the LiveDNS API and is only able to act as a DNS provider. You need to get the API key from the v5 interface.

Configuration

In your credentials file you must provide your Gandi.net API key:

{% highlight json %} { "gandi": { "apikey": "your-gandi-key" } } {% endhighlight %}

Metadata

This provider does not recognize any special metadata fields unique to Gandi.

Usage

Example Javascript:

{% highlight js %} var GANDI = NewDnsProvider("gandi", "GANDI"); var REG_GANDI = NewRegistrar("gandi", "GANDI");

D("example.tld", REG_GANDI, DnsProvider(GANDI), A("test","1.2.3.4") ); {% endhighlight %}

New domains

If a domain does not exist in your Gandi account, DNSControl will not automatically add it with the create-domains command. You'll need to do that via the control panel manually.