Solução de problemas

Veja nesta página informações sobre solução de problemas de cada versão das seguintes APIs da infraestrutura de serviços:

  • API Service Management
  • API Service Control
  • API Service Consumer Management

Como processar erros da API Service Control em geral?

A API Service Control fornece funcionalidade de plano de controle, como registro e monitoramento, para serviços gerenciados. Portanto, os chamadores da API Service Control costumam ser aplicativos de servidor. Veja algumas recomendações gerais de como processar erros no nível da API REST/RPC:

  • O servidor precisa registrar todos os erros retornados pela API Service Control, e é possível usar os dados para solucionar problemas do seu serviço gerenciado.
  • Se o servidor receber erros 429 da API Service Control, ele retornará erros 429 aos clientes.
  • Se o servidor não conseguir acessar a API Service Control, as opções serão "fail-open" (ignorar o erro) ou "fail-close" (retornar 503 ao cliente).
  • Se o servidor receber erros 500 da API Service Control, ele retornará o erro 500 aos clientes. Esses erros costumam indicar bugs na API Service Control.
  • Se o servidor receber outros erros da API Service Control, ele retornará o erro 500 aos clientes. Esses erros costumam indicar bugs no seu serviço gerenciado.

O que significa o erro "serviço não ativado"?

Para usar qualquer serviço de API do Google, você precisa ter um projeto do Google Cloud, habilitar o serviço para esse projeto e transmitir uma chave de API ou um token de acesso OAuth associado ao projeto para cada solicitação de API. Consulte o Guia de autenticação para mais detalhes. Para corrigir esse erro, você precisa ativar o serviço para seu projeto usando o console do Google Cloud, a Google Cloud CLI ou a API Service Usage. Para saber como habilitar um serviço, consulte Como habilitar e desabilitar serviços.

Como corrigir erros de permissão negada?

Esses erros tipicamente significam que o chamador não tem a permissão certa de gerenciamento de identidade e acesso em determinados recursos. Para informações sobre as permissões necessárias para cada uma das seguintes APIs da infraestrutura de serviços, consulte a respectiva página "Controle de acesso":

Como fazer uma nova tentativa após erros de API?

Uma nova tentativa é recomendada com intervalos exponenciais somados à aleatoriedade. O intervalo mínimo para uma nova tentativa deve ser de 30s para erros de cota 429 e de 1s para os erros de servidor 500 e 503. Para outros erros, uma nova tentativa deve ser feita somente com base em informações adicionais sobre o erro. Consulte google.rpc.Code para mais detalhes.

Como solicitar uma cota maior da API?

Para saber como se inscrever para uma cota mais alta para cada uma das seguintes APIs da infraestrutura de serviços, visite a seção respectiva da página Cotas e limites:

Como corrigir os erros "Não é possível verificar a propriedade do nome de domínio"?

Esse erro indica que o autor da chamada não tem a propriedade do nome de domínio usado no serviço gerenciado especificado em uma configuração de serviço. Siga o guia para usar um domínio válido.