Mensagens de erro

Nesta página, descrevemos mensagens de erro comuns que podem ser recebidas ao usar o Cloud DNS, o significado das mensagens e as ações recomendadas para resolvê-los.

Erros gerais

Esta seção descreve erros gerais.

alreadyExists

O recurso especificado já existe. Não é possível criar uma cópia.

Ação recomendada: ao criar um recurso, use a API get/list adequada para descobrir quais já existem.

Se você recebeu esse erro ao incluir registros, é porque um registro individual é tratado como um conjunto de registros. Isso significa que cada entrada (se houver mais de uma) funciona como um registro diferente. É possível incluir dois valores ou strings ao conjunto de registros do mesmo nome do Sistema de Nome de Domínio (DNS). Para fazer isso, insira um espaço entre o primeiro e o segundo valor.

Para mais informações sobre como resolver esse erro, consulte Corrigir erros de registros conflitantes.

accessNotConfigured

Acesso não configurado

Para resolver esse erro, ative a API Cloud DNS no seu projeto.

inactiveBillingState

O projeto example_project não pode aceitar solicitações enquanto estiver em um estado de faturamento inativo. A atualização do estado de faturamento pode levar alguns minutos.

Ação recomendada: ative o faturamento do projeto. Para ativar o faturamento de um novo projeto ou reativar o faturamento de um projeto atual, siga as etapas apropriadas em Ativar faturamento para um projeto.

preconditionFailed

Esse é um erro genérico que indica que algo na solicitação não é compatível com o estado atual do recurso do servidor. O cliente precisa fazer algo para corrigir isso e tentar novamente. Isso poderá acontecer se você enviar uma solicitação de mudança create que tente excluir um conjunto de registros de recurso sem qualquer correspondência entre os que já existem (mesmo nome e tipo).

Leia o estado atual da zona e decida o que você quer excluir. Pode ter havido alguma mudança desde sua última consulta.

A mensagem de erro inclui o caminho para a parte da solicitação que apresenta o problema. Por exemplo, entity.change.deletions[6] refere-se ao sétimo elemento da matriz deletions do objeto de alteração no corpo POST da solicitação.

Ação recomendada: corrija a parte da solicitação sinalizada como problemática.

required

Esse é um erro genérico que indica a falta de uma parte obrigatória na solicitação. Por exemplo, a solicitação para criar uma zona gerenciada requer um nome, um nome DNS e uma descrição. Se algum desses campos estiver ausente, a solicitação falhará com esse erro.

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

notFound

O recurso especificado não existe.

Ação recomendada: verifique se você usou o nome de um recurso que existe.

quotaExceeded

Você recebe esse erro quando uma mudança iminente excede sua cota atual. A cota é associada ao projeto. Por exemplo, só é possível usar um número definido de conjuntos de registros de recurso em cada zona. Se você precisar aumentar a cota, entre em contato com a equipe de vendas do Google Cloud. Novos projetos têm uma cota padrão, conforme especificado nas cotas e limites de recursos do Cloud DNS. Para todas as diferentes dimensões que o DNS limita, consulte a operação Projects.get.

Ação recomendada: verifique seu projeto para entender por que você usa tanto esse recurso. É possível solicitar uma cota maior para um projeto na página Cotas do Console do Google Cloud para o projeto. Consulte também Como trabalhar com cotas.

Erros relacionados a zonas gerenciadas

Esta seção lista os erros relacionados a zonas gerenciadas.

invalidFieldValue

Valor inválido para entity.managedZone.name.

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

managedZoneDnsNameNotAvailable

A zona gerenciada especificada não está disponível e, portanto, não pode ser criada.

A operação para criar uma zona gerenciada pode falhar e exibir esse erro pelos seguintes motivos:

  • O nome de DNS da zona a ser criada está reservado. Por exemplo, ponto (.), .com ou .co.uk.
  • Não há mais servidores de nomes disponíveis para hospedar o nome de DNS da zona. O Cloud DNS usa um pool de servidores de nomes, e esse pool é finito. Uma consulta DNS em qualquer servidor de nomes precisa ser mapeada inequivocamente em uma zona gerenciada. Veja mais detalhes em Limites do servidor de nomes.

Ação recomendada: se você for o proprietário registrado do nome de DNS em questão, verifique se não há sobreposição de zonas. Para configurar o DNS para um domínio e os subdomínios dele, recomendamos que você crie uma única zona pai primeiro e adicione registros para cada subdomínio nessa zona.

verifyManagedZoneDnsNameOwnership

Verifique a propriedade do domínio example.com ou de um pai e tente novamente.

Ação recomendada: ao receber esse erro, verifique quem é o proprietário do domínio e tente novamente.

Erros relacionados a registros gerenciados

Os erros desta seção são relacionados a registros.

containerNotEmpty

O registro especificado não pode ser excluído porque não está em branco.

Ação recomendada: se você quiser excluir o registro, será preciso esvaziá-lo primeiro.

invalidZoneApex

O conjunto de registros de recursos é inválido porque uma zona precisa conter exatamente um conjunto de registros de recursos de certo tipo no apex.

No contexto de DNS, Apex significa o nome de DNS com o menor número de rótulos permitido na zona. Também é o topo da hierarquia de zonas. O apex de uma zona é o nome de DNS igual a ManagedZone.dnsName.

Esse erro indica que você tentou fazer uma mudança que violaria a regra de DNS de que uma zona precisa conter exatamente um conjunto de registros de recurso de um determinado tipo no apex. As seguintes ações podem causar esse erro:

  • Você tentou excluir o conjunto de registros de recurso NS obrigatório no apex.
  • Você tentou excluir o conjunto de registros de recurso SOA obrigatório no apex.
  • Você tentou criar um conjunto de registros de recurso do tipo SOA fora do apex.

Ação recomendada: se você recebeu esse erro, significa que está tentando fazer algo que não é permitido pelas regras de DNS. Verifique se há erros na sua solicitação. Não é necessário excluir os conjuntos de registros de recurso obrigatórios.

invalidRecordCount

O conjunto de registros de recurso entity.change.additions[XX] só pode ter um registro porque é do tipo <SOA_OR_CNAME>.

As regras do DNS especificam que os conjuntos de registros de recursos SOA e CNAME só podem ter um registro de recurso. Você receberá esse erro se tentar fazer uma mudança que viole essas regras. Exemplo:

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

Ação recomendada: se receber este erro, verifique sua solicitação. Você está tentando fazer algo que não é permitido.

cnameResourceRecordSetConflict

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

Esse erro ocorre quando você cria dois tipos de conjuntos de registros de recurso, como um registro A e um registro CNAME para o mesmo nome de DNS. Uma causa comum desse erro é ao tentar criar um registro CNAME no apex da zona. Isso não é possível, porque entraria em conflito com os registros obrigatórios SOA e NS de mesmo nome.

Ação recomendada: escolha um dos dois tipos.

wildcardNotAllowed

O conjunto de registros de recurso tem o tipo errado para ser curinga.

No DNS, um curinga (em inglês) é um tipo especial de conjunto de registros de recurso que corresponde a solicitações por nomes de domínio não existentes. Uma limitação do Cloud DNS é que não é possível criar um conjunto de registros de recurso curinga com o tipo NS.

Ação recomendada: os conjuntos de registros de recurso NS curinga não são aceitos no momento. Entre em contato com o suporte do Cloud DNS ou participe do cloud-dns-discuss e compartilhe o que você está tentando fazer.

recordTypeDisallowedAtZoneApex

O registro de recurso especificado não pode existir com nenhum outro tipo de registro, incluindo o registro SOA, que é necessário no apex da zona.

Não é possível colocar um registro de recurso CNAME no apex porque ele não pode existir com qualquer outro tipo de registro de recurso, incluindo o registro SOA, que é necessário no apex da zona.

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

invalidValue

Esse é um erro genérico que indica que há algo inválido na sua solicitação, independentemente do estado do servidor. A mensagem de erro inclui o caminho para a parte da solicitação que apresenta problemas, assim como o valor inválido. Este erro pode ser gerado por diferentes fatores. Veja alguns deles abaixo:

  • Você especificou um conjunto de registros de recurso com um nome inválido. Por exemplo, foo...bar não é um nome de DNS válido (rótulo do meio vazio).
  • Você especificou um conjunto de registros de recurso com um tipo inválido. Por exemplo, A e CNAME são tipos válidos, mas XXX não é.
  • Você especificou um conjunto de registros de recurso sem registros.
  • Você especificou dados de registros de recurso inválidos. Por exemplo, 1.1.1.1 é um dado de registros de recurso válido para o tipo A. XXX é um dado de registros de recurso inválido para o tipo A.
  • Você especificou um conjunto de registros de recurso com TTL inválido. O TTL precisa ser um número inteiro não negativo.
  • Você especificou um nome de recurso muito longo.

Ação recomendada: corrija sua solicitação.

A seguir