Adresses IP
Les adresses IPv4 et IPv6 de vos VPS et leur reverse DNS.
Lister les adresses IP
GET
/v1/compute/vps/{vps_id}/ip-addressesPermission : vps:read
Paramètres de chemin
| Champ | Type | Description |
|---|---|---|
vps_idobligatoire | texte | Format : ^vps-[0-9a-f]{8}$. Exemple : "vps-7c2e4a91". |
Réponse 200
| Champ | Type | Description |
|---|---|---|
data | liste de objet | |
data[].address | texte | Adresse IPv4 ou IPv6. Exemple : "192.0.2.23". |
data[].prefix_length | entier ou null | Longueur du préfixe ; null si l’hyperviseur ne répond pas. Exemple : 24. |
data[].version | entier | Version du protocole. Valeurs : 4, 6. |
data[].primary | booléen | Adresse principale du VPS. |
data[].gateway | texte ou null | Exemple : "192.0.2.1". |
data[].reverse_dns | texte ou null | Exemple : "www.studio-laurent.fr". |
Erreurs
not_foundRessource introuvable- Et les erreurs communes :
missing_api_key,invalid_api_key,missing_scope,ip_not_allowed,rate_limited.
curl "https://api.corcelink.fr/v1/compute/vps/vps-7c2e4a91/ip-addresses" \
-H "Authorization: Bearer $CORCELINK_API_KEY"import os, uuid, requests
r = requests.get(
"https://api.corcelink.fr/v1/compute/vps/vps-7c2e4a91/ip-addresses",
headers={"Authorization": f"Bearer {os.environ['CORCELINK_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())const res = await fetch("https://api.corcelink.fr/v1/compute/vps/vps-7c2e4a91/ip-addresses", {
method: "GET",
headers: { Authorization: `Bearer ${process.env.CORCELINK_API_KEY}` },
});
console.log(res.status, await res.json());Réponse 200
{
"data": [
{
"address": "192.0.2.23",
"prefix_length": 24,
"version": 4,
"primary": true,
"gateway": "192.0.2.1",
"reverse_dns": null
},
{
"address": "2001:db8:42::2",
"prefix_length": 64,
"version": 6,
"primary": false,
"gateway": "2001:db8:42::1",
"reverse_dns": null
}
]
}Essayer avec votre clé
Votre clé reste dans ce navigateur et n’est envoyée qu’à api.corcelink.fr.
Définir le reverse DNS
PUT
/v1/compute/vps/{vps_id}/ip-addresses/{address}/reverse-dnsPermission : vps:write
Le nom doit déjà pointer vers l’adresse (enregistrement A ou AAAA). Envoyez null pour le retirer.
Paramètres de chemin
| Champ | Type | Description |
|---|---|---|
vps_idobligatoire | texte | Format : ^vps-[0-9a-f]{8}$. Exemple : "vps-7c2e4a91". |
addressobligatoire | texte | Exemple : "192.0.2.23". |
En-têtes
| Champ | Type | Description |
|---|---|---|
Idempotency-Key | texte | Clé unique (UUID conseillé) : une requête répétée avec la même clé renvoie la même réponse, sans refaire l’opération. 255 caractères au plus. |
Corps de la requête
| Champ | Type | Description |
|---|---|---|
reverse_dnsobligatoire | texte ou null | Exemple : "www.studio-laurent.fr". |
Réponse 200
| Champ | Type | Description |
|---|---|---|
address | texte | Adresse IPv4 ou IPv6. Exemple : "192.0.2.23". |
prefix_length | entier ou null | Longueur du préfixe ; null si l’hyperviseur ne répond pas. Exemple : 24. |
version | entier | Version du protocole. Valeurs : 4, 6. |
primary | booléen | Adresse principale du VPS. |
gateway | texte ou null | Exemple : "192.0.2.1". |
reverse_dns | texte ou null | Exemple : "www.studio-laurent.fr". |
Erreurs
not_foundRessource introuvablevalidation_failedDonnées invalidesreverse_dns_mismatchLe nom ne pointe pas vers l’adresseservice_not_activeService inactifresource_busyModification en coursrate_limitedTrop de requêtesservice_unavailableService momentanément indisponible- Et les erreurs communes :
missing_api_key,invalid_api_key,missing_scope,ip_not_allowed,rate_limited.
curl -X PUT "https://api.corcelink.fr/v1/compute/vps/vps-7c2e4a91/ip-addresses/192.0.2.23/reverse-dns" \
-H "Authorization: Bearer $CORCELINK_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"reverse_dns": "www.studio-laurent.fr"}'import os, uuid, requests
r = requests.put(
"https://api.corcelink.fr/v1/compute/vps/vps-7c2e4a91/ip-addresses/192.0.2.23/reverse-dns",
headers={"Authorization": f"Bearer {os.environ['CORCELINK_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
json={"reverse_dns": "www.studio-laurent.fr"},
timeout=30,
)
r.raise_for_status()
print(r.json())const res = await fetch("https://api.corcelink.fr/v1/compute/vps/vps-7c2e4a91/ip-addresses/192.0.2.23/reverse-dns", {
method: "PUT",
headers: { Authorization: `Bearer ${process.env.CORCELINK_API_KEY}`, "Idempotency-Key": crypto.randomUUID(), "Content-Type": "application/json" },
body: JSON.stringify({"reverse_dns": "www.studio-laurent.fr"}),
});
console.log(res.status, await res.json());Réponse 200
{
"address": "192.0.2.23",
"prefix_length": 24,
"version": 4,
"primary": true,
"gateway": "192.0.2.1",
"reverse_dns": "www.studio-laurent.fr"
}