Messaggi di errore

In questa pagina vengono descritti i messaggi di errore comuni che potresti ricevere quando utilizzi Cloud DNS, il significato dei messaggi e le azioni consigliate per risolvere gli errori.

Errori generali

In questa sezione vengono descritti gli errori generali.

alreadyExists

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

Azione consigliata: quando crei una risorsa, utilizza l'API get/list appropriata per individuare le risorse già esistenti.

Se viene visualizzato questo messaggio di 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 hai più voci) funziona 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 saperne di più su come risolvere l'errore, vedi Risolvere gli errori dovuti a record in conflitto.

accessNotConfigured

Accesso non configurato

Per risolvere questo errore, devi attivare 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 progetto. Per attivare la fatturazione per un nuovo progetto o per riattivare la fatturazione 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 della richiesta non è compatibile con lo stato attuale della risorsa del server. Il client deve risolvere il problema e poi riprovare. Questo può verificarsi 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 corrente della zona e scegli cosa eliminare. Potrebbe essere cambiato dall'ultima volta che hai guardato il video.

Il messaggio di errore include il percorso della parte problematica della richiesta. Ad esempio, entity.change.deletions[6] si riferisce al settimo elemento nell'array deletions dell'oggetto di modifica 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 di creazione di una zona gestita richiede un nome, un nome DNS e una descrizione. Se uno di questi campi non è presente, la richiesta ha esito negativo con 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 tua quota attuale. La quota è associata al progetto. Ad esempio, è consentito un determinato numero di set di record di risorse in ciascuna zona. Se hai bisogno di un aumento di quota, contatta il tuo team di vendita di 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 dal DNS, consulta l'operazione Projects.get.

Azione consigliata: controlla il tuo progetto per capire perché stai già utilizzando così una grande quantità di quella risorsa. Puoi richiedere un aumento della quota per un progetto nella pagina Quote di Google Cloud Console per il progetto. Puoi anche consultare la pagina relativa all'utilizzo delle quote.

Errori relativi alle zone gestite

In questa sezione sono elencati gli errori relativi alle zone gestite.

invalidFieldValue

Valore per entity.managedZone.name non valido.

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, quindi non può essere creata.

L'operazione per creare una zona gestita potrebbe non riuscire con questo errore per i motivi seguenti:

  • 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 tale pool è limitato. Una query DNS su qualsiasi server dei nomi deve essere mappata in modo univoco in una zona gestita. Per maggiori dettagli, vedi i limiti del server dei nomi.

Azione consigliata: se sei il proprietario registrato del nome DNS in questione, controlla se sono presenti zone sovrapposte. Per configurare il DNS per un dominio e i relativi sottodomini, ti consigliamo di creare prima un'unica zona padre e di aggiungere record per ciascun sottodominio della zona.

verifyManagedZoneDnsNameOwnership

Verifica la proprietà del dominio example.com (o di un dominio principale) 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 si riferiscono ai record.

containerNotEmpty

Impossibile eliminare la risorsa specificata 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 all'apice.

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

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

  • Hai tentato di eliminare il record di risorse di NS richiesto all'apice.
  • Hai tentato di eliminare il record di risorse di 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, stai tentando di eseguire un'operazione non consentita in base alle regole del DNS. Controlla se nella tua richiesta sono presenti 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 dicono che determinati set di record di risorse possono essere costituiti da un solo record di risorse. Attualmente, questo tipo può essere SOA o CNAME. Questo errore viene visualizzato 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 visualizzi questo errore, controlla la 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 tipo di set di record delle risorse specificato non è corretto come carattere jolly.

Nel DNS, una carattere jolly è un tipo speciale di set di record di risorse che corrisponde alle 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: caratteri jolly NSi set di record di risorse al momento non sono supportati. Contatta l'assistenza Cloud DNS o unisciti a cloud-dns-discussion e spiegaci che cosa stai cercando di fare.

invalidValue

Si tratta di un errore generico che indica che qualcosa della 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 che non contiene record.
  • Hai specificato dati di record di risorse non validi. Ad esempio, 1.1.1.1 è un dato di record di risorse valido per il tipo A. XXX non è un dato di record di risorse 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 di risorsa troppo lungo.

Azione consigliata: correggi la richiesta.

Passaggi successivi