Mensagens de erro

Esta página descreve as mensagens de erro comuns que pode receber quando usa o Cloud DNS, o que significam as mensagens e as ações recomendadas para resolver os erros.

Erros gerais

Esta secção descreve erros gerais.

alreadyExists

O recurso especificado já existe. Não pode criar um duplicado.

Ação recomendada: quando criar um recurso, use a get/listAPI adequada para descobrir que recursos já existem.

Se receber este erro ao adicionar registos, é porque um registo individual é tratado como um conjunto de registos, o que significa que cada entrada (se tiver várias entradas) funciona como um registo diferente. Pode adicionar dois valores ou strings ao conjunto de registos para o mesmo nome do Sistema de Nomes de Domínio (DNS) adicionando um espaço entre o primeiro valor e o segundo valor.

Para mais informações sobre como resolver este erro, consulte o artigo Corrigir erros de registos em conflito.

accessNotConfigured

Acesso não configurado

Para resolver este erro, tem de ativar a API Cloud DNS para o seu projeto.

inactiveBillingState

O projeto example_project não pode aceitar pedidos enquanto estiver num estado de faturação inativo. O estado de faturação pode demorar vários minutos a ser atualizado.

Ação recomendada: ative a faturação para o seu projeto. Para ativar a faturação para um novo projeto ou para reativar a faturação para um projeto existente, siga os passos adequados em Ative a faturação para um projeto.

preconditionFailed

Este é um erro genérico que significa que algo no pedido não é compatível com o estado atual do recurso do servidor. O cliente tem de fazer algo para corrigir o problema e, em seguida, tentar novamente. Isto pode acontecer se enviar um create pedido de alteração que tente eliminar um conjunto de registos de recursos que não corresponda ao que já existe (mesmo nome e tipo).

Leia o estado atual da zona e decida o que quer eliminar. Pode ter sido alterado desde a última vez que o consultou.

A mensagem de erro inclui o caminho para a parte problemática do seu pedido. Por exemplo, entity.change.deletions[6] refere-se ao sétimo elemento na matriz deletions do objeto de alteração no corpo POST do seu pedido.

Ação recomendada: corrija a parte do pedido que está sinalizada como problemática.

required

Este é um erro genérico que significa que está em falta alguma parte necessária do pedido. Por exemplo, o pedido de criação de uma zona gerida requer um nome, um nome DNS e uma descrição. Se algum destes campos estiver em falta, o pedido falha com este erro.

Ação recomendada: preencha o parâmetro obrigatório e tente novamente.

notFound

O recurso especificado não existe.

Ação recomendada: certifique-se de que está a usar o nome de um recurso existente.

quotaExceeded

Recebe este erro quando uma alteração iminente excede a sua quota atual. A quota está associada ao projeto. Por exemplo, só é permitido um determinado número de conjuntos de registos de recursos em cada zona. Se precisar de um aumento da quota, contacte a sua Google Cloud equipa de vendas. Os novos projetos têm uma quota predefinida, conforme especificado em Quotas e limites de recursos do Cloud DNS. Para ver todas as dimensões diferentes que o DNS limita, consulte a operação Projects.get.

Ação recomendada: verifique o seu projeto para compreender por que motivo já está a usar tanto desse recurso. Pode pedir um aumento da quota para um projeto na página Quotas da Google Cloud consola para o projeto. Também pode consultar o artigo Peça um ajuste da quota.

Erros relacionados com zonas geridas

Esta secção apresenta erros relacionados com zonas geridas.

invalidFieldValue

Valor inválido para entity.managedZone.name.

A operação para criar uma zona gerida pode falhar com este erro se o nome da zona gerida não começar com uma letra, terminar com uma letra ou um dígito e contiver apenas letras minúsculas, dígitos ou travessões.

managedZoneDnsNameNotAvailable

A zona gerida especificada não está disponível e, por isso, não pode ser criada.

A operação de criação de uma zona gerida pode falhar com este erro pelos seguintes motivos:

  • O nome DNS da zona proposta está reservado, por exemplo, ponto (.), .com ou .co.uk.
  • Não existem mais servidores de nomes disponíveis para alojar o nome DNS da zona. O Cloud DNS usa um conjunto de servidores de nomes, e esse conjunto é finito. Uma consulta DNS a qualquer servidor de nomes tem de ser mapeada de forma inequívoca para uma zona gerida. Para ver mais detalhes, consulte os limites do servidor de nomes.

Ação recomendada: se for o proprietário registado do nome DNS em questão, verifique se existem zonas sobrepostas. Para configurar o DNS de um domínio e dos respetivos subdomínios, recomendamos que crie primeiro uma única zona principal e adicione registos para cada subdomínio nessa zona.

verifyManagedZoneDnsNameOwnership

Valide a propriedade do domínio example.com (ou de um domínio principal) e, em seguida, tente novamente.

Ação recomendada: quando recebe este erro, tem de validar a propriedade do domínio e, em seguida, tentar novamente.

Erros relacionados com registos geridos

Os erros nesta secção estão relacionados com registos.

containerNotEmpty

Não é possível eliminar o recurso especificado porque não está vazio.

Ação recomendada: se quiser eliminar o recurso, tem de o esvaziar primeiro.

invalidZoneApex

O conjunto de registos de recursos especificado é inválido porque uma zona tem de conter exatamente um conjunto de registos de recursos de um determinado tipo no vértice.

Apex no contexto do DNS significa o nome DNS com o menor número de etiquetas permitidas na zona. Também é o topo da hierarquia de zonas. O vértice de uma zona é o nome DNS igual a ManagedZone.dnsName.

Este erro significa que tentou fazer uma alteração que violaria a regra de DNS de que uma zona tem de conter exatamente um conjunto de registos de recursos de um determinado tipo no vértice. As seguintes ações podem causar este erro:

  • Tentou eliminar o conjunto de registos de recursos NS obrigatório no vértice.
  • Tentou eliminar o conjunto de registos de recursos SOA obrigatório no vértice.
  • Tentou criar um conjunto de registos de recursos do tipo SOA not no vértice.

Ação recomendada: se receber este erro, está a tentar fazer algo que não é permitido pelas regras de DNS. Verifique se existem erros no seu pedido. Não é necessário eliminar os conjuntos de registos de recursos obrigatórios.

invalidRecordCount

O conjunto de registos de recursos entity.change.additions[XX] só pode ter um registo porque é do tipo <SOA_OR_CNAME>.

As regras de DNS indicam que os conjuntos de registos de recursos SOA e CNAME só podem ter um registo de recursos. Este erro é apresentado se tentar criar uma alteração que viole essas regras. Por exemplo:

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

Ação recomendada: se receber este erro, verifique o seu pedido. Está a tentar fazer algo que não é permitido.

cnameResourceRecordSetConflict

O conjunto de registos de recursos entity.change.additions[XX] é inválido porque o nome DNS example.com pode ter um conjunto de registos de recursos CNAME ou conjuntos de registos de recursos de outros tipos, mas não ambos.

Este erro ocorre quando cria dois tipos de conjuntos de registos de recursos, como um registo A e um registo CNAME para o mesmo nome de DNS. Uma causa comum deste erro é tentar criar um registo CNAME no vértice da zona. Isto não é possível porque entraria em conflito com os registos SOA e NS obrigatórios com o mesmo nome.

Ação recomendada: escolha uma das opções.

wildcardNotAllowed

O conjunto de registos de recursos especificado tem o tipo errado para ser um caráter universal.

No DNS, um caráter universal é um tipo especial de conjunto de registos de recursos que corresponde a pedidos de nomes de domínios inexistentes. Uma limitação do Cloud DNS é que não pode criar um conjunto de registos de recursos com carateres universais do tipo NS.

Ação recomendada: os conjuntos de registos de recursos com carateres universais NS não são suportados neste momento. Contacte o apoio técnico do Cloud DNS ou participe no grupo cloud-dns-discuss e partilhe o que está a tentar fazer.

recordTypeDisallowedAtZoneApex

O registo de recurso especificado não pode existir juntamente com nenhum outro tipo de registo, incluindo o registo SOA necessário no vértice da zona.

Não pode colocar um registo de recurso CNAME no vértice, porque não pode existir juntamente com qualquer outro tipo de registo de recurso, incluindo o registo de recurso SOA necessário no vértice da zona.

Ação recomendada: use um registo de recurso ALIAS. Um registo de recurso ALIAS é um tipo de registo personalizado do Cloud DNS que se comporta como um registo de recurso CNAME, mas só pode ser usado no vértice da zona e só responde a consultas de registos de endereços (A ou AAAA). Para mais informações, consulte o artigo Registos ALIAS.

invalidValue

Este é um erro genérico que significa que algo no seu pedido era inválido, independentemente do estado do servidor. A mensagem de erro inclui o caminho para a parte problemática do pedido, bem como o valor inválido. Este erro pode ser acionado por vários aspetos diferentes, como:

  • Especificou um conjunto de registos de recursos com um nome inválido. Por exemplo, cymbal...group não é um nome DNS válido (etiqueta intermédia vazia).
  • Especificou um conjunto de registos de recursos com um tipo inválido. Por exemplo, A e CNAME são tipos válidos, mas group não é um tipo válido.
  • Especificou um conjunto de registos de recursos sem registos.
  • Especificou dados de registos de recursos inválidos. Por exemplo, 1.1.1.1 são dados de registos de recursos válidos para o tipo A. X.X.X.X é um registo de recurso inválido para o tipo A.
  • Especificou um conjunto de registos de recursos com um TTL inválido. O TTL tem de ser um número inteiro não negativo.
  • Especificou um nome de recurso demasiado longo.

Ação recomendada: corrija o seu pedido.

O que se segue?