Glue records : Update

Aangemaakt: 31-08-2026

Omschrijving

Wijzig de IP-adressen van een bestaande glue record. Je geeft in de body de volledige set IP-adressen mee die na de wijziging bij de host hoort, zowel IPv4 als IPv6: de opgegeven set vervangt de bestaande adressen. Een adres dat je weglaat, wordt dus verwijderd.

Endpoint

PUT https://api.nextname.nl/v2/glue/host
Content-type: application/json

Parameters

Parameter	Datatype	Verplicht	Omschrijving
host	String	Ja	De volledige hostname van de glue record die je wijzigt, bijvoorbeeld ns1.testdomeinnaam.nl. Wordt in het pad van het endpoint meegegeven, niet in de body.
addresses	Array	Ja	De IP-adressen die na de wijziging aan de host gekoppeld zijn, elk als object met de parameters version en address
version	String	Ja	Het type IP-adres: v4 voor een IPv4-adres, v6 voor een IPv6-adres
address	String	Ja	Het IP-adres zelf, passend bij de opgegeven version • Gereserveerde adressen (bijvoorbeeld 127.0.0.1) worden geweigerd

Antwoord

HTTP status code: 204 No Content

Wordt de opdracht geweigerd — bijvoorbeeld omdat een adres gereserveerd is — dan volgt een foutmelding. Bekijk voor de opbouw daarvan de pagina Foutmelding. De wijziging is terug te vinden via History, inclusief de IP-adressen vóór en na de wijziging.

Voorbeeld

Beschrijving:
Wijzig de glue record ns1.testdomeinnaam.nl naar één IPv4-adres en één IPv6-adres.

Body:

{
  "addresses": [
    {
      "version": "v4",
      "address": "185.84.140.164"
    },
    {
      "version": "v6",
      "address": "2001:07b8:060c:0001:0004:0100:16e2:0001"
    }
  ]
}

PHP
cURL

Opdracht in PHP:

<?php
$env      = "live"; // live or test
$api_key  = "XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX";
$api_url  = "/v2/glue/ns1.testdomeinnaam.nl";
$api_host = $env === "live" ? "https://api.nextname.nl" : "https://api-test.nextname.nl";

$a_data = [
            "addresses" => [
                             ["version" => "v4", "address" => "185.84.140.164"],
                             ["version" => "v6", "address" => "2001:07b8:060c:0001:0004:0100:16e2:0001"]
                           ]
          ];

$json_data = json_encode($a_data);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_host . $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");
curl_setopt($ch, CURLOPT_POSTFIELDS, $json_data);
curl_setopt($ch, CURLOPT_HTTPHEADER, array("Authorization: Bearer $api_key", "Content-Type: application/json"));
$output = curl_exec($ch);

if(curl_getinfo($ch, CURLINFO_HTTP_CODE) === 204) {
  echo "Glue record successfully updated";
}

curl_close($ch);

Opdracht in cURL:

curl -X PUT -H "Authorization: Bearer XXXXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
-H "Content-Type: application/json" \
-d '{"addresses":[{"version":"v4","address":"185.84.140.164"},{"version":"v6","address":"2001:07b8:060c:0001:0004:0100:16e2:0001"}]}' \
https://api-test.nextname.nl/v2/glue/ns1.testdomeinnaam.nl

Antwoord:

HTTP/1.1 204 No Content