Cette page décrit les messages d'erreur courants que vous pouvez recevoir lors de l'utilisation de Cloud DNS, leur signification et les actions recommandées pour les résoudre.
Erreurs générales
Cette section décrit les erreurs générales.
alreadyExists
La ressource spécifiée existe déjà. Vous ne pouvez pas créer de doublons.
Action recommandée : Lorsque vous créez une ressource, utilisez l'API get/list
appropriée pour identifier les ressources qui existent déjà.
Si vous rencontrez cette erreur lors de l'ajout d'enregistrements, cela signifie qu'un enregistrement individuel est traité comme un jeu d'enregistrements, c'est-à-dire que chaque entrée (si vous en avez plusieurs) agit comme un enregistrement différent. Lorsque vous ajoutez deux valeurs ou chaînes au jeu d'enregistrements pour le même nom DNS (Domain Name System), vous devez insérer un espace entre la première et la deuxième valeur.
Pour en savoir plus sur la résolution de cette erreur, consultez la page Corriger les erreurs d'enregistrements en conflit.
accessNotConfigured
Accès non configuré
Pour résoudre ce problème, vous devez activer l'API Cloud DNS pour votre projet.
inactiveBillingState
Le projet
example_project
ne peut pas accepter de requêtes tant que la facturation n'est pas activée. L'activation de la facturation peut prendre plusieurs minutes.
Action recommandée : activez la facturation pour votre projet. Pour activer la facturation pour un nouveau projet ou réactiver la facturation pour un projet existant, suivez la procédure décrite dans la section Activer la facturation pour un projet.
preconditionFailed
Il s'agit d'un message d'erreur générique indiquant qu'un élément de la requête n'est pas compatible avec l'état actuel de la ressource serveur. Le client doit tenter de corriger sa requête, puis réessayer. Cela peut se produire si vous envoyez une demande de modification create
qui tente de supprimer un jeu d'enregistrements de ressources ne correspondant pas à celui qui existe déjà (même nom et même type).
Regardez l'état actuel de la zone et décidez de ce que vous souhaitez supprimer. Il est possible que cet état ait été modifié depuis la dernière fois que vous l'avez vérifié.
Le message d'erreur inclut le chemin d'accès vers la partie de votre requête qui pose problème. Par exemple, entity.change.deletions[6]
fait référence au 7e élément du tableau deletions
de l'objet "change" dans le corps du message POST de votre requête.
Action recommandée : Corrigez la partie de la requête identifiée comme problématique.
required
Il s'agit d'un message d'erreur générique indiquant qu'un élément obligatoire n'est pas présent dans la requête. Par exemple, pour effectuer une requête de création de zone gérée, il est nécessaire d'indiquer un nom, un nom DNS et une description. Si l'un de ces champs est manquant, la requête échoue avec cette erreur.
Action recommandée : Renseignez le paramètre requis et réessayez.
notFound
La ressource spécifiée n'existe pas.
Action recommandée : Assurez-vous que vous utilisez le nom d'une ressource existante.
quotaExceeded
Ce message d'erreur indique qu'une modification imminente entraînera le dépassement de votre quota actuel.
Le quota est associé au projet. Par exemple, vous ne pouvez créer qu'un certain nombre de jeux d'enregistrements de ressources dans chaque zone. Si vous avez besoin d'une augmentation du quota, contactez votre équipe commerciale Google Cloud. Les nouveaux projets disposent d'un quota par défaut comme indiqué dans Quotas et limites de ressources Cloud DNS.
Pour connaître toutes les différentes dimensions pour lesquelles DNS impose des limites, consultez l'opération Projects.get
.
Action recommandée : vérifiez votre projet pour comprendre pourquoi vous utilisez déjà une si grande partie de la ressource concernée. Vous pouvez demander une augmentation du quota d'un projet sur la page Quotas de la console Google Cloud pour le projet. Consultez également la section Utiliser des quotas.
Erreurs relatives aux zones gérées
Cette section répertorie les erreurs relatives aux zones gérées.
invalidFieldValue
Valeur incorrecte pour
entity.managedZone.name
L'opération permettant de créer une zone gérée peut échouer et renvoyer cette erreur si le nom de la zone gérée ne commence pas par une lettre, se termine par une lettre ou un chiffre et ne contient que des lettres minuscules, des chiffres ou des tirets.
managedZoneDnsNameNotAvailable
La zone gérée spécifiée n'est pas disponible et ne peut donc pas être créée.
L'opération de création d'une zone gérée peut échouer avec cette erreur pour les raisons suivantes :
- Le nom DNS de la zone proposée est réservé, par exemple le point final correspondant au domaine racine (
.
),.com
ou.co.uk
. - Il n'y a plus de serveurs de noms disponibles pour héberger le nom DNS de la zone. Cloud DNS utilise un pool de serveurs de noms dont la capacité limite est atteinte. Une requête DNS sur n'importe quel serveur de noms doit pouvoir être associée sans ambiguïté à une zone gérée spécifique. Pour plus de détails, consultez la section Limites du serveur de noms.
Action recommandée : si vous êtes le propriétaire enregistré du nom DNS en question, vérifiez la présence éventuelle de zones de chevauchement. En ce qui concerne la configuration DNS pour un domaine et ses sous-domaines, nous recommandons de créer une seule zone parente et d'ajouter des enregistrements pour chaque sous-domaine dans cette zone.
verifyManagedZoneDnsNameOwnership
Validez la propriété du domaine
example.com
(ou d'un domaine parent), puis réessayez.
Action recommandée : Lorsque vous recevez cette erreur, vous devez valider la propriété du domaine, puis réessayer.
Erreurs liées aux enregistrements gérés
Les erreurs présentées dans cette section concernent les enregistrements.
containerNotEmpty
La ressource spécifiée ne peut pas être supprimée car elle n'est pas vide.
Action recommandée : Si vous souhaitez supprimer la ressource, vous devez au préalable supprimer son contenu.
invalidZoneApex
Le jeu d'enregistrements de ressources spécifié n'est pas valide car une zone doit contenir exactement un jeu d'enregistrements de ressources d'un certain type au niveau de l'apex.
Apex
dans le contexte DNS correspond au nom DNS ayant le plus petit nombre de libellés autorisé dans la zone. Il s'agit également du sommet de la hiérarchie de la zone.
L'apex d'une zone est le nom DNS équivalent à ManagedZone.dnsName
.
Cette erreur signifie que vous avez tenté d'apporter une modification qui ne respecte pas la règle DNS : une zone doit contenir exactement un jeu d'enregistrements de ressources d'un certain type au niveau de l'apex. Les actions suivantes peuvent provoquer cette erreur :
- Vous avez essayé de supprimer le jeu d'enregistrements de ressources
NS
requis au niveau de l'apex. - Vous avez essayé de supprimer le jeu d'enregistrements de ressources
SOA
requis au niveau de l'apex. - Vous avez essayé de créer un jeu d'enregistrements de ressources de type
SOA
, mais pas au niveau de l'apex.
Action recommandée : Si vous rencontrez cette erreur, cela signifie que vous tentez d'effectuer une opération qui n'est pas autorisée par les règles du DNS. Vérifiez votre requête. Il n'y a aucune raison de supprimer les jeux d'enregistrements de ressources requis.
invalidRecordCount
Le jeu d'enregistrements de ressources
entity.change.additions[XX]
ne peut contenir qu'un seul enregistrement, car il est de type<SOA_OR_CNAME>
.
Les règles du DNS stipulent que les jeux d'enregistrements de ressources SOA
et CNAME
ne peuvent contenir qu'un seul enregistrement de ressource. Cette erreur se produit si vous essayez de créer une modification non conforme à ces règles. Exemple :
{
kind: "dns#rrset"
name: "blog.foo.com.",
type: "CNAME",
rrdata: [ "www.foo.com.", "www2.foo.com." ],
...
}
Action recommandée : si vous rencontrez cette erreur, vérifiez votre requête. Cette erreur indique que vous tentez d'effectuer une opération qui n'est pas autorisée.
cnameResourceRecordSetConflict
Le jeu d'enregistrements de ressources
entity.change.additions[XX]
n'est pas valide, car le nom DNSexample.com
peut comporter un jeu d'enregistrements de ressources CNAME ou des jeux d'enregistrements de ressources d'autres types, mais pas les deux.
Cette erreur se produit lorsque vous créez deux types de jeux d'enregistrements de ressources, tels qu'un enregistrement A et un enregistrement CNAME pour le même nom DNS. Une cause courante de cette erreur est la tentative de création d'un enregistrement CNAME au niveau de l'apex de la zone. Cela n'est pas possible car cet enregistrement entrerait en conflit avec les enregistrements SOA
et NS
requis associés au même nom.
Action recommandée : Choisissez un type d'enregistrement ou l'autre.
wildcardNotAllowed
Le jeu d'enregistrements de ressources spécifié n'a pas le bon type pour obtenir le statut d'enregistrement générique.
Dans le système DNS, un enregistrement générique est un type particulier de jeu d'enregistrements de ressources qui permet le traitement des requêtes concernant des noms de domaine qui n'existent pas. Cloud DNS ne permet pas encore de créer des jeux d'enregistrements de ressources génériques de type NS
.
Action recommandée : Les jeux d'enregistrements de ressources génériques de type NS
ne sont pas acceptés pour le moment. Contactez l'assistance Cloud DNS ou rejoignez le groupe cloud-dns-discuss pour nous expliquer ce que vous tentez de mettre en œuvre.
recordTypeDisallowedAtZoneApex
L'enregistrement de ressources spécifié ne peut pas coexister avec d'autres types d'enregistrements, y compris l'enregistrement
SOA
qui est obligatoire au niveau de l'apex de la zone.
Vous ne pouvez pas placer un enregistrement de ressources CNAME
au niveau de l'apex, car il ne peut pas coexister avec d'autres types d'enregistrements de ressources, y compris l'enregistrement de ressources SOA
qui lui est obligatoire.
Action recommandée:Utilisez un enregistrement de ressource ALIAS
. Un enregistrement de ressources ALIAS
est un type d'enregistrement personnalisé de Cloud DNS qui se comporte comme un enregistrement de ressources CNAME
, mais qui ne peut être utilisé qu'au niveau de l'apex de la zone et qui ne répond qu'aux requêtes d'enregistrement d'adresses (A ou AAAA). Pour en savoir plus, consultez la section Enregistrements d'alias.
invalidValue
Il s'agit d'un message d'erreur générique indiquant qu'un élément de votre requête n'est pas valide. Ce type de message n'est pas lié à l'état du serveur. Le message d'erreur inclut le chemin d'accès à la partie problématique de la requête, ainsi que la valeur non valide. Les opérations pouvant entraîner cette erreur sont multiples :
- Vous avez spécifié un jeu d'enregistrements de ressources avec un nom qui n'est pas valide. Par exemple,
foo...bar
n'est pas un nom DNS valide (libellé central absent). - Vous avez spécifié un jeu d'enregistrements de ressources dont le type n'est pas valide. Par exemple, A et CNAME sont des types valides, mais XXX n'est pas un type valide.
- Vous avez spécifié un jeu d'enregistrements de ressources ne comportant aucun enregistrement.
- Vous avez spécifié des données d'enregistrement de ressources non valides. Par exemple,
1.1.1.1
est une donnée d'enregistrement de ressource valide pour le type A. XXX est une donnée d'enregistrement de ressource non valide pour le type A. - Vous avez spécifié un jeu d'enregistrements de ressources dont le TTL n'est pas valide. Le TTL doit être un entier non négatif.
- Vous avez spécifié un nom de ressource trop long.
Action recommandée : Corrigez votre requête.
Étape suivante
- Pour en savoir plus sur les fonctionnalités, consultez la page Présentation de Cloud DNS.
- Pour trouver des solutions aux problèmes courants que vous pouvez rencontrer lors de l'utilisation de Cloud DNS, consultez la page Dépannage.
- Pour obtenir une aide supplémentaire, consultez la page Assistance.