Messaggi di errore

Questa pagina descrive i messaggi di errore comuni che potresti ricevere quando utilizzi Cloud DNS, il loro significato e le azioni consigliate per risolvere gli errori.

Errori generali

Questa sezione descrive gli errori generali.

alreadyExists

La risorsa specificata esiste già, pertanto non puoi creare un duplicato.

Azione consigliata: quando crei una risorsa, utilizza l'API get/list appropriata per scoprire quali esistono già.

Se ricevi questo errore durante l'aggiunta di record, ciò è dovuto al fatto che un singolo record viene trattato come un insieme di record, il che significa che ogni voce (se ne è presente più di una) funge da record diverso. Puoi aggiungere due valori o stringhe al set di record per lo stesso nome DNS (Domain Name System) inserendo uno spazio tra il primo e il secondo valore.

Per saperne di più su come risolvere questo errore, consulta Risolvi gli errori dovuti a record in conflitto.

accessNotConfigured

Accesso non configurato

Per risolvere questo errore, devi abilitare l'API Cloud DNS per il tuo progetto.

inactiveBillingState

Il progetto example_project non può accettare richieste mentre è in uno stato di fatturazione inattivo. L'aggiornamento dello stato di fatturazione potrebbe richiedere alcuni minuti.

Azione consigliata: abilita la fatturazione per il tuo progetto. Per abilitare la fatturazione per un nuovo progetto o riattivarla per un progetto esistente, segui i passaggi appropriati descritti in Abilita la fatturazione per un progetto.

preconditionFailed

Si tratta di un errore generico che indica che parte della richiesta non è compatibile con lo stato attuale della risorsa server. Il client deve intervenire per risolvere il problema e poi riprovare. Questo errore può verificarsi se invii una richiesta di modifica create che tenta di eliminare un set di record di risorse che non corrisponde a quello esistente (stesso nome e tipo).

Prima di decidere cosa vuoi eliminare, leggi lo stato attuale della zona, in quanto potrebbe essere cambiato dall'ultima volta che l'hai visualizzato.

Il messaggio di errore include il percorso della parte problematica della richiesta. Ad esempio, entity.change.deletions[6] si riferisce al settimo elemento dell'array deletions dell'oggetto change nel corpo POST della richiesta.

Azione consigliata: correggi la parte della richiesta segnalata come problematica.

required

Si tratta di un errore generico che indica che manca una parte obbligatoria della richiesta. Ad esempio, la richiesta di creazione di una zona gestita richiede un nome, un nome DNS e una descrizione. Se manca uno di questi campi, la richiesta non va a buon fine e viene visualizzato questo errore.

Azione consigliata: compila il parametro richiesto e riprova.

notFound

La risorsa specificata non esiste.

Azione consigliata: assicurati di utilizzare il nome di una risorsa esistente.

quotaExceeded

Questo errore si verifica quando una modifica imminente supererebbe la quota attuale. La quota è associata al progetto. Ad esempio, è consentito solo un determinato numero di set di record di risorse in ogni zona. Se hai bisogno di un aumento della quota, contatta il team di vendita di Cloud de Confiance . I nuovi progetti hanno una quota predefinita come specificato in Quote e limiti delle risorse Cloud DNS. Per tutte le diverse dimensioni limitate dal DNS, consulta la pagina relativa all'operazione Projects.get.

Azione consigliata: controlla il tuo progetto per capire perché stai già utilizzando una quantità così elevata di questa risorsa. Puoi richiedere un aumento della quota per un progetto nella pagina Quote della console Cloud de Confiance per il progetto. Puoi anche fare riferimento a Richiedi un aggiustamento delle quote.

Errori relativi alle zone gestite

Questa sezione elenca gli errori relativi alle zone gestite.

invalidFieldValue

Valore non valido per entity.managedZone.name.

L'operazione di creazione di una zona gestita può non riuscire con questo errore se il nome della zona gestita non inizia con una lettera, non termina con una lettera o una cifra e non contiene solo lettere minuscole, cifre o trattini.

managedZoneDnsNameNotAvailable

La zona gestita specificata non è disponibile e pertanto non può essere creata.

L'operazione di creazione di una zona gestita può non riuscire con questo errore per i seguenti motivi:

• Il nome DNS della zona proposta è riservato, ad esempio punto (.), .com o .co.uk.
• Non sono disponibili altri server dei nomi per ospitare il nome DNS della zona. Cloud DNS utilizza un pool di server dei nomi e questo pool è limitato. Una query DNS a un qualsiasi server dei nomi deve essere mappata in modo univoco a una zona gestita. Per maggiori dettagli, consulta Limiti per i server dei nomi.

Azione consigliata: se sei il proprietario registrato del nome DNS in questione, verifica se sono presenti zone sovrapposte. Per configurare il DNS per un dominio e i relativi sottodomini, ti consigliamo di creare prima una singola zona padre e di aggiungere i record per ogni sottodominio in quella zona.

verifyManagedZoneDnsNameOwnership

Verifica la proprietà del dominio example.com (o di un dominio padre), quindi riprova.

Azione consigliata: quando ricevi questo errore, devi verificare la proprietà del dominio e poi riprovare.

Errori relativi ai record gestiti

Gli errori in questa sezione riguardano i record.

containerNotEmpty

La risorsa specificata non può essere eliminata perché non è vuota.

Azione consigliata: se vuoi eliminare la risorsa, devi prima svuotarla.

invalidZoneApex

Il set di record di risorse specificato non è valido perché una zona deve contenere esattamente un set di record di risorse di un determinato tipo nell'apex.

Nel contesto del DNS, Apex indica il nome DNS con il minor numero di etichette consentite nella zona. È anche il livello superiore della gerarchia della zona. L'apex di una zona è il nome DNS corrispondente a ManagedZone.dnsName.

Questo errore significa che hai tentato di apportare una modifica che violerebbe la regola DNS secondo cui una zona deve contenere esattamente un set di record di risorse di un determinato tipo nell'apex. Le seguenti azioni possono causare questo errore:

• Hai tentato di eliminare il set di record di risorse NS obbligatorio nell'apex.
• Hai tentato di eliminare il set di record di risorse SOA obbligatorio nell'apex.
• Hai tentato di creare un set di record di risorse di tipo SOA non nell'apex.

Azione consigliata: se ricevi questo errore, stai tentando di eseguire un'operazione non consentita dalle regole del DNS. Controlla che non siano presenti errori nella richiesta. Non è necessario eliminare i set di record di risorse richiesti.

invalidRecordCount

Il set di record di risorse entity.change.additions[XX] può avere un solo record perché è di tipo <SOA_OR_CNAME>

Le regole del DNS prevedono che i set di record di risorse SOA e CNAME possano avere un solo record di risorse. Ricevi questo errore se provi a creare una modifica che violerebbe queste regole. Ad esempio:

  {
    kind: "dns#rrset"
    name: "blog.example.com.",
    type: "CNAME",
    rrdata: [ "www.example.com.", "www2.example.com." ],
    ...
  }

Azione consigliata: se ricevi questo errore, controlla la richiesta. Stai tentando eseguire un'operazione che non è consentita.

cnameResourceRecordSetConflict

Il set di record di risorse entity.change.additions[XX] non è valido perché il nome DNS example.com può avere un solo set di record di risorse CNAME oppure più set di record di risorse di altri tipi, ma non entrambi.

Questo errore si verifica quando crei due tipi di set di record di risorse, ad esempio un record A e un record CNAME per lo stesso nome DNS. Una causa comune di questo errore è il tentativo di creare un record CNAME nell'apex della zona. Questa operazione non è possibile perché entrerebbe in conflitto con i record SOA e NS obbligatori con lo stesso nome.

Azione consigliata: scegli una delle due opzioni.

wildcardNotAllowed

Il set di record di risorse specificato non è del tipo corretto per avere caratteri jolly.

Nel DNS, i record con caratteri jolly sono un tipo speciale di set di record di risorse per la corrispondenza delle richieste di nomi di dominio inesistenti. Un limite di Cloud DNS è che non puoi creare un set di record di risorse con caratteri jolly di tipo NS.

Azione consigliata: al momento, i set di record di risorse con caratteri jolly NS non sono supportati. Contatta l'assistenza Cloud DNS oppure unisciti alla conversazione cloud-dns-discuss e condividi ciò che stai cercando di fare.

recordTypeDisallowedAtZoneApex

Il record di risorse specificato non può coesistere con nessun altro tipo di record, incluso il record SOA obbligatorio nell'apex della zona.

Non puoi inserire un record di risorse CNAME nell'apex perché non può coesistere con nessun altro tipo di record di risorse, incluso il record di risorse SOA obbligatorio nell'apex della zona.

Azione consigliata: utilizza un record di risorse ALIAS. Un record di risorse ALIAS è un tipo di record personalizzato di Cloud DNS che si comporta come un record di risorse CNAME, ma può essere utilizzato solo nell'apex della zona e risponde solo alle query sui record di indirizzo (A o AAAA). Per saperne di più, consulta Record alias.

invalidValue

Si tratta di un errore generico che indica che una parte della richiesta non era valida, indipendentemente dallo stato del server. Il messaggio di errore include il percorso della parte problematica della richiesta, nonché il valore non valido. Questo errore può essere attivato da molti fattori diversi, ad esempio:

• Hai specificato un set di record di risorse con un nome non valido. Ad esempio, cymbal...group non è un nome DNS valido (etichetta centrale vuota).
• Hai specificato un set di record di risorse con un tipo non valido. Ad esempio, A e CNAME sono tipi validi, mentre group non lo è.
• Hai specificato un set di record di risorse senza record.
• Hai specificato dati di record di risorse non validi. Ad esempio, 1.1.1.1 sono dati di record di risorse validi per il tipo A. X.X.X.X sono dati di record di risorse non validi per il tipo A.
• Hai specificato un set di record di risorse con un TTL non valido. Il TTL deve essere un numero intero non negativo.
• Hai specificato un nome della risorsa troppo lungo.

Azione consigliata: correggi la richiesta.