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 risolverli.

Errori generali

Questa sezione descrive gli errori generali.

alreadyExists

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

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

Se ricevi questo errore quando aggiungi record, significa che un singolo record viene trattato come un insieme di record, il che significa che ogni voce (se ne hai 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) aggiungendo uno spazio tra il primo valore e il secondo.

Per ulteriori informazioni su come risolvere questo errore, consulta Risolvere 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 se è 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 attivare la fatturazione per un nuovo progetto o per riattivarla per un progetto esistente, segui i passaggi appropriati descritti in Abilitare la fatturazione per un progetto.

preconditionFailed

Si tratta di un errore generico che indica che un aspetto della richiesta non è compatibile con lo stato attuale della risorsa del server. Il cliente deve fare qualcosa per risolvere il problema e riprovare. Questo può accadere se invii una create richiesta di modifica che tenta di eliminare un insieme di record di risorse che non corrisponde a quello già esistente (stessa denominazione e stesso tipo).

Leggi lo stato attuale della zona e decidi cosa eliminare. 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] fa riferimento al settimo elemento dell'array deletions dell'oggetto di modifica 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 con 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 viene visualizzato quando una modifica imminente supererebbe la quota attuale. La quota è associata al progetto. Ad esempio, puoi avere 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 Google Cloud. I nuovi progetti hanno una quota predefinita, come specificato in Quote e limiti delle risorse Cloud DNS. Per tutte le diverse dimensioni limitate da DNS, consulta l'operazione Projects.get.

Azione consigliata: controlla il tuo progetto per capire perché stai già utilizzando così tanta risorsa. Puoi richiedere un aumento della quota per un progetto nella pagina Quote della console Google Cloud per il progetto. Puoi anche consultare Utilizzo 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, termina con una lettera o una cifra e 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, che è limitato. Una query DNS a qualsiasi server dei nomi deve mapparsi in modo univoco a una zona gestita. Per ulteriori dettagli, consulta i limiti per i nameserver.

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

verifyManagedZoneDnsNameOwnership

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

Azione consigliata:quando ricevi questo errore, devi verificare la proprietà del dominio e 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.

Apex nel contesto DNS indica il nome DNS con il minor numero di etichette consentite nella zona. È anche la parte superiore della gerarchia delle zone. L'apice di una zona è il nome DNS uguale a ManagedZone.dnsName.

Questo errore indica che hai provato a apportare una modifica che violerebbe la regola DNS che prevede che una zona debba contenere esattamente un set di record di risorse di un determinato tipo all'apice. Le seguenti azioni possono causare questo errore:

  • Hai provato a eliminare il set di record di risorse NS richiesto all'apice.
  • Hai provato a eliminare il set di record di risorse SOA richiesto all'apice.
  • Hai provato a creare un set di record di risorse di tipo SOA not nell'apex.

Azione consigliata:se ricevi questo errore, stai tentando di eseguire un'operazione non consentita dalle regole del DNS. Controlla la richiesta per verificare la presenza di errori. 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 indicano che i set di record di risorse SOA e CNAME possono avere un solo record di risorse. Questo errore si verifica se provi a creare una modifica che violi queste regole. Ad esempio:

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

Azione consigliata:se ricevi questo errore, controlla la richiesta. Stai tentando di eseguire un'azione non consentita.

cnameResourceRecordSetConflict

Il set di record di risorse entity.change.additions[XX] non è valido perché il nome DNS example.com potrebbe 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 all'apice della zona. Ciò non è possibile perché entrerebbe in conflitto con i record SOA e NS obbligatori dello stesso nome.

Azione consigliata:scegli una delle due opzioni.

wildcardNotAllowed

Il set di record di risorse specificato non è del tipo corretto per essere un carattere jolly.

In DNS, un carattere jolly è un tipo speciale di set di record di risorse che corrisponde alle richieste di nomi di dominio inesistenti. Una limitazione 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 NS con caratteri jolly non sono supportati. Contatta l'assistenza Cloud DNS o partecipa al gruppo cloud-dns-discuss e condividi ciò che stai cercando di realizzare.

recordTypeDisallowedAtZoneApex

Il record di risorse specificato non può esistere insieme a 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ò essere associato a 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 Cloud DNS che si comporta come un record di risorse CNAME, ma può essere utilizzato solo nell'apice della zona e risponde solo alle query relative ai record di indirizzi (A o AAAA). Per ulteriori informazioni, consulta Record ALIAS.

invalidValue

Si tratta di un errore generico che indica che un aspetto della tua richiesta non è valido, indipendente dallo stato del server. Il messaggio di errore include il percorso della parte problematica della richiesta, nonché il valore non valido. Questo errore potrebbe essere attivato da molti fattori diversi, ad esempio:

  • Hai specificato un set di record di risorse con un nome non valido. Ad esempio,foo...bar 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, ma XXX non lo è.
  • Hai specificato un set di record di risorse senza record.
  • Hai specificato dati record della risorsa non validi. Ad esempio, 1.1.1.1 è dati di record di risorse validi per il tipo A. XXX non è un dato del record di risorsa valido 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.

Passaggi successivi