github.com/teknogeek/dnscontrol/v2@v2.10.1-0.20200227202244-ae299b55ba42/docs/_providers/gandi.md (about)

     1  ---
     2  name: Gandi
     3  title: Gandi Provider
     4  layout: default
     5  jsId: GANDI
     6  ---
     7  # Gandi Provider
     8  
     9  There are two providers for Gandi:
    10  
    11   1. `GANDI` uses the v3 API and is able to act as a registrar provider
    12      and a DNS provider. It is not able to handle domains that have
    13      migrated to the new LiveDNS API. You need to get the API key from
    14      the [v4 interface][].
    15  
    16   2. `GANDI-LIVEDNS` uses the LiveDNS API and is only able to act as a
    17      DNS provider. You need to get the API key from the [v5 interface][].
    18  
    19  [v4 interface]: https://v4.gandi.net
    20  [v5 interface]: https://v5.gandi.net
    21  
    22  ## Configuration
    23  In your credentials file you must provide your Gandi.net API key:
    24  
    25  {% highlight json %}
    26  {
    27    "gandi": {
    28      "apikey": "your-gandi-key"
    29    }
    30  }
    31  {% endhighlight %}
    32  
    33  ## Metadata
    34  This provider does not recognize any special metadata fields unique to Gandi.
    35  
    36  ## Usage
    37  Example Javascript:
    38  
    39  {% highlight js %}
    40  var GANDI = NewDnsProvider("gandi", "GANDI");
    41  var REG_GANDI = NewRegistrar("gandi", "GANDI");
    42  
    43  D("example.tld", REG_GANDI, DnsProvider(GANDI),
    44      A("test","1.2.3.4")
    45  );
    46  {% endhighlight %}
    47  
    48  ## New domains
    49  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.
    50  
    51  
    52  ## Common errors
    53  
    54  This is the error we see when someone uses GANDI instead of GANDI-LIVEDNS.
    55  
    56  ```
    57  Error getting corrections: error: "Error on object : OBJECT_ZONE (CAUSE_NOTFOUND) [no such zone (id: 0)]" code: 581042
    58  ```