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, usa l'API get/list appropriata per scoprire quali risorse esistono già.

Se ricevi questo errore durante l'aggiunta di record, significa che un singolo record viene considerato come un set di record, il che significa che ogni voce (se hai più voci) agisce come un 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 e il secondo valore.

Per ulteriori informazioni su come risolvere questo errore, vedi Correggere gli errori dovuti a record in conflitto.

accessNotConfigured

Accesso non configurato

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

inactiveBillingState

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

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

preconditionFailed

Si tratta di un errore generico che indica che qualcosa nella richiesta non è compatibile con lo stato attuale della risorsa del server. Il client deve fare qualcosa per risolverlo e poi riprovare. Questo può accadere se invii una richiesta di modifica create che tenta di eliminare un set di record di risorse che non corrisponde a quello già esistente (stesso nome e tipo).

Leggi lo stato attuale della zona e decidi cosa eliminare. Potrebbe essere cambiata dall'ultima volta che l'hai guardata.

Il messaggio di errore include il percorso della parte della richiesta che presenta problemi. Ad esempio, entity.change.deletions[6] si riferisce al settimo elemento nell'array deletions dell'oggetto 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 uno di questi campi non è presente, la richiesta non va a buon fine e viene restituito questo errore.

Azione consigliata: inserisci il parametro richiesto e riprova.

notFound

La risorsa specificata non esiste.

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

quotaExceeded

Ricevi questo errore quando una modifica imminente supera la quota attuale. La quota è associata al progetto. Ad esempio, è consentito solo un determinato numero di set di record di risorse in ciascuna 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 di Cloud DNS. Per tutte le diverse dimensioni limitate da DNS, vedi l'operazione Projects.get.

Azione consigliata: controlla il tuo progetto per capire perché stai già utilizzando una tale quantità di risorse. 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 per creare 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, 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 il 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 per qualsiasi server dei nomi deve essere mappata in modo univoco a una zona gestita. Per maggiori dettagli, vedi limiti per i server dei nomi.

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

verifyManagedZoneDnsNameOwnership

Verifica la proprietà del dominio example.com (o di un dominio principale), quindi 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 certo tipo all'apice.

Apex nel contesto DNS indica il nome DNS con il minor numero di etichette consentite nella zona. Inoltre, è il vertice della gerarchia delle zone. L'apice di una zona è il nome DNS uguale a ManagedZone.dnsName.

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

  • Hai tentato di eliminare il set di record di risorse NS richiesto all'apice.
  • Hai tentato di eliminare il set di record di risorse SOA richiesto all'apice.
  • Hai tentato di creare un set di record di risorse di tipo SOA non all'apice.

Azione consigliata: se ricevi questo errore, significa che stai tentando di eseguire un'operazione non consentita dalle regole del DNS. Controlla che la tua richiesta non contenga 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 stabiliscono che i set di record di risorse SOA e CNAME possono avere un solo record di risorse. Ricevi questo errore se provi a creare una modifica che violi tali regole. Ad esempio:

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

Azione consigliata: se viene visualizzato questo errore, controlla la tua richiesta. Stai cercando di fare qualcosa che non è consentito.

cnameResourceRecordSetConflict

Il set di record di risorse entity.change.additions[XX] non è valido perché il nome DNS example.com potrebbe avere un set di record di risorse CNAME oppure 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'apice della zona. Ciò non è possibile perché sarebbe 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 è di tipo errato come 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 di Cloud DNS o partecipa a cloud-dns-discuss e condividi ciò che stai cercando di svolgere.

recordTypeDisallowedAtZoneApex

Il record di risorse specificato non può esistere insieme a qualsiasi altro tipo di record, incluso il record SOA obbligatorio all'apice della zona.

Non puoi inserire un record di risorse CNAME all'apice perché non può esistere insieme ad altri tipi di record di risorse, incluso il record di risorse SOA obbligatorio all'apice 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 del record di indirizzi (A o AAAA). Per ulteriori informazioni, consulta la sezione Record alias.

invalidValue

Si tratta di un errore generico che indica che qualcosa nella richiesta non era valido, 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 causato 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 è un tipo valido.
  • Hai specificato un set di record di risorse senza record.
  • I dati del record di risorse specificati non sono validi. Ad esempio, 1.1.1.1 contiene dati di record di risorse validi per il tipo A. XXX è un record di risorse non 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 risorsa troppo lungo.

Azione consigliata: correggi la richiesta.

Passaggi successivi