Messaggi di errore

Questa pagina descrive 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

Questa sezione descrive gli errori generali.

alreadyExists

La risorsa specificata esiste già, pertanto non puoi crearne una duplicata.

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

Se ricevi questo errore durante l'aggiunta di record, è perché 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 e il secondo valore.

Per saperne di più su come risolvere questo errore, vedi 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 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 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 cliente deve fare qualcosa per risolvere il problema e poi riprovare. Ciò può verificarsi se invii una richiesta di modifica create che tenta di eliminare un insieme di record di risorse che non corrisponde a quello già esistente (stesso nome e tipo).

Leggi lo stato attuale della zona e decidi cosa vuoi 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] 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 obbligatorio 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 tua 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 Trusted Cloud . I nuovi progetti hanno una quota predefinita come specificato in Quote e limiti delle risorse Cloud DNS. Per tutte le diverse dimensioni che DNS limita, consulta l'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 Trusted Cloud per il progetto. Puoi anche fare riferimento a Richiedere 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 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 è finito. Una query DNS a qualsiasi server dei nomi deve essere mappata in modo univoco a una zona gestita. Per ulteriori dettagli, consulta 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 singola zona principale e di aggiungere 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.

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 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 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 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 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 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 all'apice della zona. Ciò non è possibile perché entrerebbe 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 non è del tipo corretto per essere un carattere jolly.

Nel DNS, un 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 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 o unisciti al gruppo cloud-dns-discuss e condividi ciò che stai cercando di fare.

recordTypeDisallowedAtZoneApex

Il record di risorse specificato non può esistere insieme a nessun altro tipo di record, incluso il record SOA richiesto nell'apex della zona.

Non puoi inserire un record di risorse CNAME nell'apex perché non può esistere insieme 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 di 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 di indirizzi (A o AAAA). Per ulteriori informazioni, vedi Record alias.

invalidValue

Si tratta di un errore generico che indica che qualcosa nella tua 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 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 risorsa 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.

Passaggi successivi