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

In questa sezione vengono descritti gli errori generali.

alreadyExists

La risorsa specificata esiste già. Impossibile creare un duplicato.

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

Se viene visualizzato questo errore durante l'aggiunta di record, significa che un singolo record viene trattato come un set di record, il che significa che ogni voce (se disponi di 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, consulta Correggere gli errori relativi ai 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 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 server. Il client deve fare qualcosa per risolverlo e 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] fa riferimento al settimo elemento dell'array deletions dell'oggetto change nel corpo POST della richiesta.

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

required

Si tratta di un errore generico che indica che manca una parte obbligatoria della richiesta. Ad esempio, la richiesta per creare una zona gestita richiede un nome, un nome DNS e una descrizione. Se uno di questi campi non è presente, la richiesta non riesce 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 supererebbe 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 dal 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 del progetto. Puoi anche fare riferimento a 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, numeri o trattini.

managedZoneDnsNameNotAvailable

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

L'operazione per creare 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 qualsiasi server dei nomi deve essere mappata in modo univoco a una zona gestita. Per maggiori dettagli, consulta la pagina sui limiti dei nameserver.

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 di aggiungere 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 al 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 violerebbe la regola DNS secondo cui una zona deve contenere esattamente un set di record di risorse di un certo tipo nell'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 non nell'apice.

Azione consigliata: se visualizzi questo errore, stai tentando di eseguire un'operazione non consentita dalle regole del DNS. Verifica 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 affermano che i set di record di risorse SOA e CNAME possono avere un solo record di risorse. Ricevi questo errore se tenti di creare una modifica che viola queste regole. Ad esempio:

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

Azione consigliata: se visualizzi questo errore, controlla la tua richiesta. Stai tentando 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 o 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. Questo non è possibile perché sarebbe in conflitto con i record SOA e NS richiesti con lo stesso nome.

Azione consigliata: scegli una delle due opzioni.

wildcardNotAllowed

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

In DNS, un caratteri jolly è un tipo speciale di set di record di risorse che corrisponde a richieste di nomi di dominio inesistenti. Un limite di Cloud DNS è che non è possibile creare un set di record di risorse con caratteri jolly di tipo NS.

Azione consigliata: i set di record di risorse NS con caratteri jolly non sono attualmente supportati. Contatta l'assistenza Cloud DNS o unisciti a cloud-dns-discuss e condividi ciò che stai cercando di ottenere.

recordTypeDisallowedAtZoneApex

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

Non puoi inserire un record di risorse CNAME all'apice perché non può esistere insieme a qualsiasi altro tipo di record di risorse, incluso il record di risorse SOA obbligatorio nell'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 dei record degli 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 e 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 è un 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.
  • Il nome della risorsa specificato è troppo lungo.

Azione consigliata: correggi la richiesta.

Passaggi successivi