Mensagens de erro

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

Erros gerais

Esta seção descreve erros gerais.

alreadyExists

O recurso especificado já existe; você não pode criar uma duplicata.

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

Se você receber este erro ao adicionar registros, é porque um registro individual é tratado como um conjunto de registros, o que significa que cada entrada (se houver várias entradas) atua como um registro diferente. Você pode adicionar dois valores ou strings ao conjunto de registros para o mesmo nome do Sistema de Nomes de Domínio (DNS) adicionando um espaço entre o primeiro e o segundo valor.

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

accessNotConfigured

Acesso não configurado

Para resolver esse erro, você deve habilitar a API do Cloud DNS para seu projeto.

inactiveBillingState

O projeto example_project não pode aceitar solicitações enquanto estiver em um estado de faturamento inativo. O estado de faturamento pode levar vários minutos para ser atualizado.

Ação recomendada: Habilite a cobrança para o seu projeto. Para habilitar a cobrança para um novo projeto ou reabilitar a cobrança para um projeto existente, siga as etapas apropriadas em Habilitar a cobrança para um projeto .

preconditionFailed

Este é um erro genérico que significa que algo na solicitação não é compatível com o estado atual do recurso do servidor. O cliente precisa fazer algo para corrigir o problema e tentar novamente. Isso pode acontecer se você enviar uma solicitação de alteração create que tente excluir um conjunto de registros de recurso que não corresponde ao que já existe (mesmo nome e tipo).

Leia o estado atual da zona e decida o que deseja excluir. Pode ter mudado desde a última vez que você a visualizou.

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

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

required

Este é um erro genérico que significa que alguma parte necessária da solicitação está ausente. 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 este erro.

Ação recomendada: preencha o parâmetro necessário e tente novamente.

notFound

O recurso especificado não existe.

Ação recomendada: certifique-se de estar usando o nome de um recurso existente.

quotaExceeded

Você recebe este erro quando uma alteração iminente excede sua cota atual. A cota está associada ao projeto. Por exemplo, você só tem permissão para um determinado número de conjuntos de registros de recursos em cada zona. Se precisar de um aumento de cota, entre em contato com seu Google Cloud Equipe de vendas. Novos projetos têm uma cota padrão, conforme especificado em 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ê já está usando tanto desse recurso. Você pode solicitar um aumento de cota para um projeto na página Cotas do projeto. Google Cloud console para o projeto. Você também pode consultar Solicitar um ajuste de cota .

Erros relacionados a zonas gerenciadas

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

invalidFieldValue

Valor inválido para entity.managedZone.name .

A operação para criar uma zona gerenciada pode falhar com este erro se o nome da zona gerenciada não começar com uma letra, terminar com uma letra ou 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 com esse erro pelos seguintes motivos:

  • O nome DNS da zona proposta é reservado, por exemplo, ponto ( . ), .com ou .co.uk .
  • Não há mais servidores de nomes disponíveis para hospedar 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 deve mapear inequivocamente para uma zona gerenciada. Para mais detalhes, consulte limites de servidores de nomes .

Ação recomendada: Se você for o proprietário registrado do nome DNS em questão, verifique se há zonas sobrepostas. Para configurar o DNS para um domínio e seus subdomínios, recomendamos criar primeiro uma zona pai única e adicionar registros para cada subdomínio nessa zona.

verifyManagedZoneDnsNameOwnership

Verifique a propriedade do domínio example.com (ou de um dos pais) e tente novamente.

Ação recomendada: Ao receber esse erro, você deve verificar a propriedade do domínio e tentar novamente.

Erros relacionados a registros gerenciados

Os erros nesta seção estão relacionados aos registros.

containerNotEmpty

O recurso especificado não pode ser excluído porque não está vazio.

Ação recomendada: se você quiser excluir o recurso, primeiro esvazie-o.

invalidZoneApex

O conjunto de registros de recursos especificado é inválido porque uma zona deve conter exatamente um conjunto de registros de recursos de um determinado tipo no ápice.

Apex no contexto de DNS significa o nome DNS com o menor número de rótulos permitidos na zona. É também o topo da hierarquia da zona. O ápice de uma zona é o nome DNS equivalente a ManagedZone.dnsName .

Este erro significa que você tentou fazer uma alteração que violaria a regra do DNS de que uma zona deve conter exatamente um conjunto de registros de recursos de um determinado tipo no ápice. As seguintes ações podem causar este erro:

  • Você tentou excluir o conjunto de registros de recursos NS necessário no apex.
  • Você tentou excluir o conjunto de registros de recursos SOA necessário no apex.
  • Você tentou criar um conjunto de registros de recursos do tipo SOA que não está no apex.

Ação recomendada: Se você receber este 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 há necessidade de excluir os conjuntos de registros de recursos necessários.

invalidRecordCount

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

As regras do DNS determinam que os conjuntos de registros de recursos SOA e CNAME podem ter apenas um registro de recurso. Você receberá este erro se tentar criar uma alteração que viole essas regras. Por exemplo:

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

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

cnameResourceRecordSetConflict

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

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

Ação recomendada: escolha uma ou outra.

wildcardNotAllowed

O conjunto de registros de recursos especificado tem o tipo errado para ser um curinga.

No DNS, um curinga é um tipo especial de conjunto de registros de recursos que corresponde a solicitações para nomes de domínio inexistentes. Uma limitação do Cloud DNS é que você não pode criar um conjunto de registros de recursos curinga do tipo NS .

Ação recomendada: Conjuntos de registros de recursos NS curinga não são suportados no momento. Entre em contato com o Suporte do Cloud DNS ou participe do cloud-dns-discuss e compartilhe o que você está tentando realizar.

recordTypeDisallowedAtZoneApex

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

Você não pode colocar um registro de recurso CNAME no apex porque ele não pode existir junto com nenhum outro tipo de registro de recurso, incluindo o registro de recurso SOA que é necessário no apex da zona.

Ação recomendada: usar 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 ápice da zona e responde apenas a consultas de registro de endereço (A ou AAAA). Para obter mais informações, consulte Registros de alias .

invalidValue

Este é um erro genérico que significa que algo na sua solicitação era inválido, independentemente do estado do servidor. A mensagem de erro inclui o caminho para a parte problemática da solicitação, bem como o valor inválido. Esse erro pode ser acionado por diversos fatores, como:

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

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

O que vem a seguir

,

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

Erros gerais

Esta seção descreve erros gerais.

alreadyExists

O recurso especificado já existe; você não pode criar uma duplicata.

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

Se você receber este erro ao adicionar registros, é porque um registro individual é tratado como um conjunto de registros, o que significa que cada entrada (se houver várias entradas) atua como um registro diferente. Você pode adicionar dois valores ou strings ao conjunto de registros para o mesmo nome do Sistema de Nomes de Domínio (DNS) adicionando um espaço entre o primeiro e o segundo valor.

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

accessNotConfigured

Acesso não configurado

Para resolver esse erro, você deve habilitar a API do Cloud DNS para seu projeto.

inactiveBillingState

O projeto example_project não pode aceitar solicitações enquanto estiver em um estado de faturamento inativo. O estado de faturamento pode levar vários minutos para ser atualizado.

Ação recomendada: Habilite a cobrança para o seu projeto. Para habilitar a cobrança para um novo projeto ou reabilitar a cobrança para um projeto existente, siga as etapas apropriadas em Habilitar a cobrança para um projeto .

preconditionFailed

Este é um erro genérico que significa que algo na solicitação não é compatível com o estado atual do recurso do servidor. O cliente precisa fazer algo para corrigir o problema e tentar novamente. Isso pode acontecer se você enviar uma solicitação de alteração create que tente excluir um conjunto de registros de recurso que não corresponde ao que já existe (mesmo nome e tipo).

Leia o estado atual da zona e decida o que deseja excluir. Pode ter mudado desde a última vez que você a visualizou.

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

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

required

Este é um erro genérico que significa que alguma parte necessária da solicitação está ausente. 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 este erro.

Ação recomendada: preencha o parâmetro necessário e tente novamente.

notFound

O recurso especificado não existe.

Ação recomendada: certifique-se de estar usando o nome de um recurso existente.

quotaExceeded

Você recebe este erro quando uma alteração iminente excede sua cota atual. A cota está associada ao projeto. Por exemplo, você só tem permissão para um determinado número de conjuntos de registros de recursos em cada zona. Se precisar de um aumento de cota, entre em contato com seu Google Cloud Equipe de vendas. Novos projetos têm uma cota padrão, conforme especificado em 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ê já está usando tanto desse recurso. Você pode solicitar um aumento de cota para um projeto na página Cotas do projeto. Google Cloud console para o projeto. Você também pode consultar Solicitar um ajuste de cota .

Erros relacionados a zonas gerenciadas

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

invalidFieldValue

Valor inválido para entity.managedZone.name .

A operação para criar uma zona gerenciada pode falhar com este erro se o nome da zona gerenciada não começar com uma letra, terminar com uma letra ou 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 com esse erro pelos seguintes motivos:

  • O nome DNS da zona proposta é reservado, por exemplo, ponto ( . ), .com ou .co.uk .
  • Não há mais servidores de nomes disponíveis para hospedar 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 deve mapear inequivocamente para uma zona gerenciada. Para mais detalhes, consulte limites de servidores de nomes .

Ação recomendada: Se você for o proprietário registrado do nome DNS em questão, verifique se há zonas sobrepostas. Para configurar o DNS para um domínio e seus subdomínios, recomendamos criar primeiro uma zona pai única e adicionar registros para cada subdomínio nessa zona.

verifyManagedZoneDnsNameOwnership

Verifique a propriedade do domínio example.com (ou de um dos pais) e tente novamente.

Ação recomendada: Ao receber esse erro, você deve verificar a propriedade do domínio e tentar novamente.

Erros relacionados a registros gerenciados

Os erros nesta seção estão relacionados aos registros.

containerNotEmpty

O recurso especificado não pode ser excluído porque não está vazio.

Ação recomendada: se você quiser excluir o recurso, primeiro esvazie-o.

invalidZoneApex

O conjunto de registros de recursos especificado é inválido porque uma zona deve conter exatamente um conjunto de registros de recursos de um determinado tipo no ápice.

Apex no contexto de DNS significa o nome DNS com o menor número de rótulos permitidos na zona. É também o topo da hierarquia da zona. O ápice de uma zona é o nome DNS equivalente a ManagedZone.dnsName .

Este erro significa que você tentou fazer uma alteração que violaria a regra do DNS de que uma zona deve conter exatamente um conjunto de registros de recursos de um determinado tipo no ápice. As seguintes ações podem causar este erro:

  • Você tentou excluir o conjunto de registros de recursos NS necessário no apex.
  • Você tentou excluir o conjunto de registros de recursos SOA necessário no apex.
  • Você tentou criar um conjunto de registros de recursos do tipo SOA que não está no apex.

Ação recomendada: Se você receber este 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 há necessidade de excluir os conjuntos de registros de recursos necessários.

invalidRecordCount

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

As regras do DNS determinam que os conjuntos de registros de recursos SOA e CNAME podem ter apenas um registro de recurso. Você receberá este erro se tentar criar uma alteração que viole essas regras. Por exemplo:

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

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

cnameResourceRecordSetConflict

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

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

Ação recomendada: escolha uma ou outra.

wildcardNotAllowed

O conjunto de registros de recursos especificado tem o tipo errado para ser um curinga.

No DNS, um curinga é um tipo especial de conjunto de registros de recursos que corresponde a solicitações para nomes de domínio inexistentes. Uma limitação do Cloud DNS é que você não pode criar um conjunto de registros de recursos curinga do tipo NS .

Ação recomendada: Conjuntos de registros de recursos NS curinga não são suportados no momento. Entre em contato com o Suporte do Cloud DNS ou participe do cloud-dns-discuss e compartilhe o que você está tentando realizar.

recordTypeDisallowedAtZoneApex

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

Você não pode colocar um registro de recurso CNAME no apex porque ele não pode existir junto com nenhum outro tipo de registro de recurso, incluindo o registro de recurso SOA que é necessário no apex da zona.

Ação recomendada: usar 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 ápice da zona e responde apenas a consultas de registro de endereço (A ou AAAA). Para obter mais informações, consulte Registros de alias .

invalidValue

Este é um erro genérico que significa que algo na sua solicitação era inválido, independentemente do estado do servidor. A mensagem de erro inclui o caminho para a parte problemática da solicitação, bem como o valor inválido. Esse erro pode ser acionado por diversos fatores, como:

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

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

O que vem a seguir