--- title: "Configurer les DNS de son nom de domaine" description: "Utiliser l'API publique OVHcloud pour configurer les DNS de votre nom de domaine" url: https://docs.ovhcloud.com/fr/guides/web-cloud/domains/api-domain-dns lang: fr lastUpdated: 2026-02-10 --- # Configurer les DNS de son nom de domaine :::info Pour suivre ce guide, vous devez déjà vous connecter à l’API OVHcloud. Vous trouverez plus de détails sur la page d’[introduction à l’API](/fr/guides/web-cloud/domains/api-domain-intro.md). ::: ## Sommaire - [Introduction](/fr/guides/web-cloud/domains/api-domain-intro.md) - [Commander un nom de domaine](/fr/guides/web-cloud/domains/api-domain-order.md) - [Gestion des tâches](/fr/guides/web-cloud/domains/api-domain-tasks.md) - [Gestion des contacts d’un nom de domaine](/fr/guides/web-cloud/domains/api-domain-contacts.md) - [Gestion des règles d’éligibilité](/fr/guides/web-cloud/domains/api-domain-rules.md) - [Configurer l’affichage de ses données dans le Whois](/fr/guides/web-cloud/domains/api-domain-whois.md) - **Configurer les DNS de son nom de domaine** - [Transférer un nom de domaine](/fr/guides/web-cloud/domains/api-domain-transfer.md) ## Introduction Cette page décrit les informations liées à la résolution DNS des noms de domaine. Cela regroupe : - la déclaration des serveurs de noms; - les glue records. ## Types de configuration DNS La configuration DNS sur un nom de domaine peut être de type `hosted` ou `external`. Le type `hosted` signifie que la zone DNS est gérée de manière automatique par OVHcloud. Cela vous permet de ne pas avoir à créer vous même votre propre serveur de noms. Vous avez bien sûr la main sur le contenu de cette zone, mais le choix des serveurs sur lesquels est hébergée la zone n’est pas modifiable. En contrepartie, OVHcloud s’occupera de la déclaration de ces serveurs auprès du registre ainsi que de la gestion du DNSSEC. ### Récupération du type de configuration DNS d’un nom de domaine [](#) En utilisant l’API suivante, il est possible de récupérer le type de serveur de noms défini sur un nom de domaine. 🇪🇺EU▾ [GET/domain/{serviceName}](https://eu.api.ovh.com/console/?section=/domain&branch=v1#get-/domain/-serviceName-) | Paramètre | Obligatoire | Description | | ------------- | ----------- | -------------------------- | | `serviceName` | oui | Le nom de domaine concerné | **Exemple de réponse** ```js { "parentService": null, "domain": "test.com", "offer": "gold", "dnssecSupported": true, "owoSupported": true, "transferLockStatus": "locked", "whoisOwner": "123456", "hostSupported": true, "glueRecordIpv6Supported": true, "glueRecordMultiIpSupported": true, "lastUpdate": "2021-11-02T12:01:13+01:00", "nameServerType": "hosted" } ``` Comme nous pouvons le voir sur l’exemple ci-dessus, le type de configuration DNS est indiqué dans le champ `nameServerType`. Nous pouvons aussi voir, grâce au champ `hostSupported`, que les hosts sont supportés comme des entités par le registre du nom de domaine. Cela aura son importance par la suite, si vous décidez de déclarer des **glue records** sur votre nom de domaine. ### Mise à jour du type de configuration DNS d’un nom de domaine L’API suivante permet de mettre à jour certaines configurations du nom de domaine, y compris le type de serveur de noms. 🇪🇺EU▾ [PUT/domain/{serviceName}](https://eu.api.ovh.com/console/?section=/domain&branch=v1#put-/domain/-serviceName-) | Paramètre | Obligatoire | Description | | ----------------------------------- | ----------- | ------------------------------------------------- | | `serviceName` | oui | Le nom de domaine concerné | | `nameServerType` (corps de requête) | oui | Type de DNS à configurer (`hosted` ou `external`) | **Exemple de requête** ```js { "nameServerType": "external" // (hosted ou external) } ``` Comme nous pouvons le voir dans l’exemple ci-dessus, le type de configuration DNS du nom de domaine a été changé à `external`. Il est important de savoir que : - Pour passer de `external` à `hosted`, il est nécessaire de disposer d’une zone DNS chez OVHcloud pour pouvoir faire la modification. Il est possible d’en commander une via l’espace client OVHcloud. - Pour passer de `hosted` à `external`, vous devez faire la modification et ensuite changer la déclaration des serveurs de noms du nom de domaine comme expliqué dans la section suivante. ## Déclaration des serveurs de noms Lorsque le `nameServerType` d’un nom de domaine est `external`, il est nécessaire de configurer les serveurs de noms auprès du registre pour pouvoir les résoudre. Si le `nameServerType` est `hosted`, il est toujours possible de consulter les serveurs de noms déclarés sur son nom de domaine via les APIs `GET` ci-dessous. Attention cependant, il ne faut pas confondre déclaration des serveurs de noms et gestion de la zone DNS. La gestion de vos zones OVHcloud se fait via la route : 🇪🇺EU▾ [GET/domain/zone/{zoneName}](https://eu.api.ovh.com/console/?section=/domain&branch=v1#get-/domain/zone/-zoneName-) ### Récupération des serveurs de noms déclarés sur un nom de domaine [](#) En utilisant l’API suivante, il est possible de récupérer les IDs des serveurs de noms définis sur un nom de domaine. 🇪🇺EU▾ [GET/domain/{serviceName}/nameServer](https://eu.api.ovh.com/console/?section=/domain&branch=v1#get-/domain/-serviceName-/nameServer) | Paramètre | Obligatoire | Description | | ------------- | ----------- | -------------------------- | | `serviceName` | oui | Le nom de domaine concerné | **Exemple de réponse** ```js [ 33578504, 33578505 ] ``` Comme nous pouvons le voir sur l’exemple ci-dessus, cet appel permet de récupérer les identifiants correspondant aux serveurs DNS déclarés sur un nom de domaine. Pour avoir le détail d’un serveur de noms, il faut appeler l’API suivante : 🇪🇺EU▾ [GET/domain/{serviceName}/nameServer/{id}](https://eu.api.ovh.com/console/?section=/domain&branch=v1#get-/domain/-serviceName-/nameServer/-id-) | Paramètre | Obligatoire | Description | | ------------- | ----------- | ----------------------------------------------------- | | `serviceName` | oui | Le nom de domaine concerné | | `id` | oui | L’ID du serveur de noms déclaré sur le nom de domaine | **Exemple de réponse** ```js { "id": 33578504, "host": "ns16.ovh.net", "ip": null, "isUsed": true, "toDelete": false } ``` Cet appel permet d’avoir les détails techniques du serveur de noms comme le `host` ou l'`ip` associée s’il s’agit d’un **glue record** (cf. [déclaration des glue records](#glue-records). D’autres informations sont également accessibles via l’API suivante : 🇪🇺EU▾ [GET/domain/{serviceName}/nameServer/{id}/status](https://eu.api.ovh.com/console/?section=/domain&branch=v1#get-/domain/-serviceName-/nameServer/-id-/status) | Paramètre | Obligatoire | Description | | ------------- | ----------- | ----------------------------------------------------- | | `serviceName` | oui | Le nom de domaine concerné | | `id` | oui | L’ID du serveur de noms déclaré sur le nom de domaine | **Exemple de réponse** ```js { "state": "ok", "type": "hosted", "usedSince": "2021-11-02T11:59:13.177558+01:00" } ``` ### Modification des serveurs de noms déclarés sur un nom de domaine [](#) Pour rappel, vous ne pouvez modifier la declaration de vos serveurs de noms que si le `nameServerType` du nom de domaine est `external`. Si c’est bien le cas, plusieurs APIs sont à votre disposition et sont décrites dans cette partie. L’API suivante permet d’ajouter de nouveaux serveurs de noms sur votre nom de domaine. 🇪🇺EU▾ [POST/domain/{serviceName}/nameServer](https://eu.api.ovh.com/console/?section=/domain&branch=v1#post-/domain/-serviceName-/nameServer) | Paramètre | Obligatoire | Description | | ------------------------------- | ----------- | -------------------------- | | `serviceName` | oui | Le nom de domaine concerné | | `nameServer` (corps de requête) | oui | Serveurs de noms à ajouter | **Exemple de requête** ```js { "nameServer": [ { // When a registry like eurid (.eu) does not support hosts, declare the glue records directly here "host": "ns1.test.eu", "ip": "140.2.113.151" }, { "host": "ns1.other-domain.eu" } ] } ``` **Exemple de réponse** ```js { "id": 414283125, "status": "todo", "function": "DomainDnsUpdate", "creationDate": "2022-04-07T15:56:01.593746+02:00", "todoDate": "2022-04-07T15:56:01+02:00", "lastUpdate": "2022-04-07T15:56:01+02:00", "doneDate": null, "canRelaunch": false, "canAccelerate": false, "canCancel": true } ``` Cette route va ajouter les nouveaux serveurs de noms sur le nom de domaine et lancer une tâche de synchronisation `DomainDnsUpdate` auprès du registre. Vous pourrez suivre cette tâche via les [APIs dédiées](/fr/guides/web-cloud/domains/api-domain-tasks.md#view-pending-tasks). Il est aussi possible de remplacer complètement la déclaration des serveurs de noms d’un nom de domaine en passant par l’API suivante : 🇪🇺EU▾ [POST/domain/{serviceName}/nameServers/update](https://eu.api.ovh.com/console/?section=/domain&branch=v1#post-/domain/-serviceName-/nameServers/update) | Paramètre | Obligatoire | Description | | ------------------------------- | ----------- | ------------------------------------------------- | | `serviceName` | oui | Le nom de domaine concerné | | `nameServer` (corps de requête) | oui | Serveurs de noms à declarer sur le nom de domaine | **Exemple de requête** ```js { "nameServer": [ { "host": "ns1.other-domain.com" }, { "host": "ns2.other-domain.com" } ] } ``` **Exemple de réponse** ```js { "id": 414283126, "status": "todo", "function": "DomainDnsUpdate", "creationDate": "2022-04-07T15:56:01.593746+02:00", "todoDate": "2022-04-07T15:56:01+02:00", "lastUpdate": "2022-04-07T15:56:01+02:00", "doneDate": null, "canRelaunch": false, "canAccelerate": false, "canCancel": true } ``` Cette route va remplacer la déclaration des serveurs de noms sur le nom de domaine et, comme la route précédente, lancer une tâche de synchronisation `DomainDnsUpdate` auprès du registre que vous pourrez suivre via les [APIs dédiées](/fr/guides/web-cloud/domains/api-domain-tasks.md#view-pending-tasks). Il est aussi possible de supprimer un serveur de noms déclaré sur un nom de domaine via l’API suivante : 🇪🇺EU▾ [DELETE/domain/{serviceName}/nameServer/{id}](https://eu.api.ovh.com/console/?section=/domain&branch=v1#delete-/domain/-serviceName-/nameServer/-id-) | Paramètre | Obligatoire | Description | | ------------- | ----------- | ----------------------------------------------------- | | `serviceName` | oui | Le nom de domaine concerné | | `id` | oui | L’ID du serveur de noms déclaré sur le nom de domaine | **Exemple de réponse** ```js { "id": 414283127, "status": "todo", "function": "DomainDnsUpdate", "creationDate": "2022-04-07T15:56:01.593746+02:00", "todoDate": "2022-04-07T15:56:01+02:00", "lastUpdate": "2022-04-07T15:56:01+02:00", "doneDate": null, "canRelaunch": false, "canAccelerate": false, "canCancel": true } ``` Cette route va supprimer le serveur de noms déclaré sur votre nom de domaine et lancer une tâche de mise à jour `DomainDnsUpdate` auprès du registre que vous pourrez suivre via les [APIs dédiées](/fr/guides/web-cloud/domains/api-domain-tasks.md#view-pending-tasks). ## Déclaration des glue records [](#) Un **glue record** permet de définir l’**adresse IP** d’un **serveur de noms** de façon à ce que le nom de domaine puisse être résolu dans le cas où ce dernier utilise des **serveurs de noms** hébergés sous ce même nom de domaine. Par exemple, si vous voulez déclarer le serveur de noms `ns1.test.com` sur le nom de domaine `test.com`, il faut fournir une IP au registre pour que la résolution ne boucle pas. Si aucune IP n’était fournie, lors de la résolution DNS de `test.com`, le résolveur DNS essaierait de résoudre le serveur de noms `ns1.test.com` en allant chercher la resolution de `test.com`, créant une boucle infinie de résolution. Il existe deux manières de gérer les glue records déclarés sur un nom de domaine. En fonction du registre, les glues records sont : - Soit déclarés via des objets **host** dédiés et manipulés comme des entités à part entière. Dans ce cas, il faudra utiliser les APIs dédiées aux **glue records**. - Soit déclarées directement en même temps que les serveurs de noms en fournissant une IP. Dans ce cas, il faudra utiliser les APIs des serveurs de noms. Pour savoir quelles APIs utiliser, il faut récupérer l’information via [la configuration DNS](#dns-setup-type) du nom de domaine, dans le champ `hostSupported`. ### Récupération des glue records déclarés sur un nom de domaine Si le champ `hostSupported` de la configuration DNS du nom de domaine est à `false`, la récupération se fait via les [APIs de serveurs de noms](#name-servers-declared) décrites plus haut. Si le champ `hostSupported` de la configuration DNS du nom de domaine est à `true`, vous pourrez modifier les **hosts** déclarés sur un nom de domaine via les APIs suivantes : 🇪🇺EU▾ [GET/domain/{serviceName}/glueRecord](https://eu.api.ovh.com/console/?section=/domain&branch=v1#get-/domain/-serviceName-/glueRecord) | Paramètre | Obligatoire | Description | | ------------- | ----------- | -------------------------- | | `serviceName` | oui | Le nom de domaine concerné | **Exemple de réponse** ```js [ "ns1.test.com", "ns2.test.com" ] ``` Pour avoir les détails d’un **glue record**, il faut récupérer le host et utiliser l’API suivante : 🇪🇺EU▾ [GET/domain/{serviceName}/glueRecord/{host}](https://eu.api.ovh.com/console/?section=/domain&branch=v1#get-/domain/-serviceName-/glueRecord/-host-) | Paramètre | Obligatoire | Description | | ------------- | ----------- | -------------------------- | | `serviceName` | oui | Le nom de domaine concerné | | `host` | oui | Le host recherché | **Exemple de réponse** ```js { "host": "ns1.test.com", "ips": [ "140.2.113.151" ] } ``` ### Modification des glue records déclarés sur un nom de domaine Si le champ `hostSupported` de la configuration DNS du nom de domaine est à `false`, la récupération se fait via les [APIs de serveurs de noms](#modify-name-servers-declared) décrites plus haut. Si le champ `hostSupported` de la configuration DNS du nom de domaine est à `true`, il est possible de manipuler les **hosts** déclarés sur un nom de domaine via les APIs dédiées aux **glue records**. #### Créer un nouveau glue record L’API suivante permet d’ajouter un **glue record** sur votre nom de domaine. 🇪🇺EU▾ [POST/domain/{serviceName}/glueRecord](https://eu.api.ovh.com/console/?section=/domain&branch=v1#post-/domain/-serviceName-/glueRecord) | Paramètre | Obligatoire | Description | | ------------------------- | ----------- | ------------------------------- | | `serviceName` | oui | Le nom de domaine concerné | | `host` (corps de requête) | oui | Le host du glue record à créer | | `ips` (corps de requête) | oui | Les adresses IPs du glue record | **Exemple de requête** ```js { "host": "ns1.test.com", "ips": [ "140.2.113.151" ] } ``` **Exemple de réponse** ```js { "id": 414283128, "status": "todo", "function": "DomainHostCreate", "creationDate": "2022-04-07T15:56:01.593746+02:00", "todoDate": "2022-04-07T15:56:01+02:00", "lastUpdate": "2022-04-07T15:56:01+02:00", "doneDate": null, "canRelaunch": false, "canAccelerate": false, "canCancel": true } ``` Cette route va lancer une tâche `DomainHostCreate` pour créer le **host** auprès du registre du nom de domaine. Vous pourrez suivre cette tâche via les [APIs dédiées](/fr/guides/web-cloud/domains/api-domain-tasks.md#view-pending-tasks). :::warning Une fois le **host** créé auprès du registre, il faut le déclarer sur votre nom de domaine via les [APIs des serveurs de nom](#modify-name-servers-declared). ::: #### Modifier un glue record existant Il est aussi possible de mettre à jour un **glue record** via l’API suivante : 🇪🇺EU▾ [POST/domain/{serviceName}/glueRecord/{host}](https://eu.api.ovh.com/console/?section=/domain&branch=v1#post-/domain/-serviceName-/glueRecord/-host-) | Paramètre | Obligatoire | Description | | ------------------------------- | ----------- | -------------------------- | | `serviceName` | oui | Le nom de domaine concerné | | `host` | oui | Le host concerné | | `glueRecord` (corps de requête) | oui | Le glue record modifié | **Exemple de requête** ```js { "host": "ns1.test.`com", "ips": [ "140.2.113.152" ] } ``` **Exemple de réponse** ```js { "id": 414283129, "status": "todo", "function": "DomainHostUpdate", "creationDate": "2022-04-07T15:56:01.593746+02:00", "todoDate": "2022-04-07T15:56:01+02:00", "lastUpdate": "2022-04-07T15:56:01+02:00", "doneDate": null, "canRelaunch": false, "canAccelerate": false, "canCancel": true } ``` Cette route va lancer une tâche `DomainHostUpdate` pour modifier le **host** auprès du registre du nom de domaine. Vous pourrez suivre cette tâche via les [APIs dédiées](/fr/guides/web-cloud/domains/api-domain-tasks.md#view-pending-tasks). Vous n’aurez pas besoin de redéclarer le serveur de nom sur le nom de domaine. Il aussi possible de supprimer un **glue record** mais, pour cela, il faudra commencer par enlever le **host** de la déclaration faite sur le nom de domaine en utilisant les [APIs des serveurs de nom](#modify-name-servers-declared). #### Supprimer un glue record existant Vous pouvez appeler l’API suivante pour supprimer le **glue record** : 🇪🇺EU▾ [DELETE/domain/{serviceName}/glueRecord/{host}](https://eu.api.ovh.com/console/?section=/domain&branch=v1#delete-/domain/-serviceName-/glueRecord/-host-) | Paramètre | Obligatoire | Description | | ------------- | ----------- | ------------------------------------------------ | | `serviceName` | oui | Le nom de domaine concerné | | `host` | oui | Le host correspondant au glue record à supprimer | **Exemple de réponse** ```js { "id": 414283130, "status": "todo", "function": "DomainHostDelete", "creationDate": "2022-04-07T15:56:01.593746+02:00", "todoDate": "2022-04-07T15:56:01+02:00", "lastUpdate": "2022-04-07T15:56:01+02:00", "doneDate": null, "canRelaunch": false, "canAccelerate": false, "canCancel": true } ``` Cette route va lancer une tâche `DomainHostDelete` pour supprimer le **host** auprès du registre du nom de domaine. Vous pourrez suivre cette tâche via les [APIs dédiées](/fr/guides/web-cloud/domains/api-domain-tasks.md#view-pending-tasks).