Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ API Gateway/ Guia de usuário/ Chamada de API publicada/ Códigos de erro

Atualizado em 2023-05-11 GMT+08:00

Ver PDF

Códigos de erro

A Tabela 1 lista os códigos de erro que você pode encontrar ao chamar APIs. Se um código de erro começando com APIGW for retornado após chamar uma API, corrija a falha consultando as instruções fornecidas em Códigos de erro.

Para obter detalhes sobre os códigos de erro que podem ocorrer quando você gerencia APIs, consulte Códigos de erro.
Se ocorrer um erro ao usar APIG, localize a mensagem de erro e a descrição na tabela a seguir de acordo com o código de erro, por exemplo, APIG.0101. As mensagens de erro estão sujeitas a alterações sem aviso prévio.

**Tabela 1** Códigos de erro
Código de erro	Mensagem de erro	Código de status HTTP	Descrição	Solução
APIG.0101	A API não existe ou não foi publicada no ambiente.	404	A API não existe ou não foi publicada no ambiente.	Verifique se o nome de domínio, o método e o caminho são consistentes com os da API registrada. Verifique se a API foi publicada. Se tiver sido publicado em um ambiente que não seja de produção, verifique se o cabeçalho X-Stage na solicitação é o nome do ambiente. Verifique se o nome de domínio usado para chamar a API foi vinculado ao grupo ao qual a API pertence.
APIG.0101	A API não existe.	404	O método de solicitação da API não existe.	Verifique se o método de solicitação da API é o mesmo que o método definido pela API.
APIG.0103	O back-end não existe.	500	O serviço de back-end não foi encontrado.	Entre em contato com o suporte técnico.
APIG.0104	Os plug-ins não existem.	500	Nenhuma configuração de plug-in foi encontrada.	Entre em contato com o suporte técnico.
APIG.0105	As configurações de back-end não existem.	500	Nenhuma configuração de back-end foi encontrada.	Entre em contato com o suporte técnico.
APIG.0106	Erro de orquestração.	400	Ocorreu um erro de orquestração.	Verifique se os parâmetros front-end e back-end da API estão corretos.
APIG.0201	Erro de solicitação da API.	400	Parâmetros de solicitação inválidos.	Defina parâmetros de solicitação válidos.
APIG.0201	Entidade de solicitação muito grande.	413	O corpo da solicitação excede 12 MB.	Reduza o tamanho do corpo da solicitação.
APIG.0201	URI de solicitação muito grande.	414	O URI da solicitação excede 32 KB.	Reduza o tamanho do URI da solicitação.
APIG.0201	Cabeçalhos de solicitação muito grandes.	494	Os cabeçalhos de solicitação são muito grandes porque um deles excede 32 KB ou o comprimento total excede 128 KB.	Reduza o tamanho dos cabeçalhos da solicitação.
APIG.0201	Back-end indisponível.	502	O serviço de back-end não está disponível.	Verifique se o endereço de back-end configurado para a API está acessível.
APIG.0201	Tempo limite de back-end.	504	O serviço de back-end expirou o tempo limite.	Aumente a duração do tempo limite do serviço de back-end ou reduza o tempo de processamento.
APIG.0201	Um erro inesperado ocorreu	500	Ocorreu um erro interno.	Entre em contato com o suporte técnico.
APIG.0202	Back-end indisponível	502	O back-end não está disponível.	Verifique se o protocolo de solicitação de back-end configurado para a API é o mesmo que o protocolo de solicitação usado pelo serviço de back-end.
APIG.0204	O protocolo SSL não é suportado: TLSv1.1	400	A versão do protocolo SSL não é suportada.	Use uma versão suportada do protocolo SSL.
APIG.0301	Informações incorretas de autenticação do IAM.	401	Os detalhes de autenticação do IAM estão incorretos.	Verifique se o token está correto.
APIG.0302	O usuário do IAM não está autorizado a acessar a API.	403	O usuário do IAM não tem permissão para acessar a API.	Verifique se o usuário é controlado por uma lista negra ou lista branca.
APIG.0303	Informações de autenticação da aplicação incorretas.	401	Os detalhes de autenticação da aplicação estão incorretos.	Verifique se o método de solicitação, caminho, cadeia de consulta e corpo da solicitação são consistentes com os usados para assinatura; verifique se a data e a hora no cliente estão corretas; e verifique se o código de assinatura está correto, referindo-se a Chamar APIs por meio de autenticação de aplicação.
APIG.0304	A aplicação não está autorizado a acessar a API.	403	A aplicação não tem permissão para acessar a API.	Verifique se a aplicação foi autorizada a acessar a API.
APIG.0305	Informações de autenticação incorretas.	401	As informações de autenticação estão incorretas.	Verifique se as informações de autenticação estão corretas.
APIG.0306	Acesso à API negado.	403	O acesso à API não é permitido.	Verifique se você foi autorizado a acessar a API.
APIG.0307	O token deve ser atualizado.	401	O token precisa ser atualizado.	Obtenha um novo token do IAM.
APIG.0308	O limite de limitação foi atingido.	429	O limite de limitação foi atingido.	Tente novamente depois que a limitação for retomada. Se o número de solicitações de domínio de depuração por dia for atingido, vincule um nome de domínio independente ao serviço ao qual a API pertence.
APIG.0310	O projeto não está disponível.	403	O projeto está indisponível no momento.	Selecione outro projeto e tente novamente.
APIG.0311	Informações de autenticação de depuração incorretas.	401	Os detalhes de autenticação de depuração estão incorretos.	Entre em contato com o suporte técnico.
APIG.0401	Endereço IP do cliente desconhecido.	403	O endereço IP do cliente não pode ser identificado.	Entre em contato com o suporte técnico.
APIG.0402	O endereço IP não está autorizado para acessar a API.	403	O endereço IP não tem permissão para acessar a API.	Verifique se o endereço IP é controlado por uma lista negra ou lista branca.
APIG.0404	O acesso ao endereço IP de back-end foi negado.	403	O endereço IP do back-end não pode ser acessado.	Verifique se o endereço IP do back-end ou o endereço IP correspondente ao nome de domínio do back-end está acessível.
APIG.0501	A cota da aplicação foi usada.	405	A cota da aplicação foi atingida.	Aumentar a cota da aplicação.
APIG.0502	A aplicação foi congelada.	405	A aplicação foi congelada.	Verifique se o saldo da sua conta é suficiente.
APIG.0601	Erro de servidor interno.	500	Ocorreu um erro interno.	Entre em contato com o suporte técnico.
APIG.0602	Solicitação inválida.	400	Pedido inválido.	Verifique se a solicitação é válida.
APIG.0605	Falha na resolução do nome de domínio.	500	Falha na resolução do nome de domínio.	Verifique se o nome de domínio está correto e foi vinculado a um endereço de back-end correto.
APIG.0606	Falha ao carregar as configurações da API.	500	As configurações da API não puderam ser carregadas.	Entre em contato com o suporte técnico.
APIG.0607	O seguinte protocolo é suportado: {xxx}	400	O protocolo não é suportado. Somente xxx é suportado. xxx está sujeito ao valor real na resposta.	Use HTTP ou HTTPS para acessar a API.
APIG.0608	Falha ao obter o token de administrador.	500	Os detalhes da conta de administrador não podem ser obtidos.	Entre em contato com o suporte técnico.
APIG.0609	O back-end da VPC não existe.	500	O serviço de back-end da carga de trabalho não pode ser encontrado.	Entre em contato com o suporte técnico.
APIG.0610	Nenhum back-end disponível.	502	Não há serviços de back-end disponíveis.	Verifique se todos os serviços de back-end estão disponíveis. Por exemplo, verifique se as informações de chamada da API são consistentes com a configuração real.
APIG.0611	A porta de back-end não existe.	500	A porta de back-end não foi encontrada.	Entre em contato com o suporte técnico.
APIG.0612	Uma API não pode chamar a si mesma.	500	Uma API não pode chamar a si mesma.	Modifique as configurações de back-end e garanta que o número de camadas que a API é chamada recursivamente não exceda 10.
APIG.0613	O serviço IAM não está disponível no momento.	503	O IAM não está disponível no momento.	Entre em contato com o suporte técnico.
APIG.0705	Falha no cálculo da assinatura de back-end.	500	Falha no cálculo da assinatura de back-end.	Entre em contato com o suporte técnico.
APIG.0802	O usuário do IAM é proibido na região selecionada no momento	403	O usuário do IAM está desativado na região atual.	Entre em contato com o suporte técnico.
APIG.1009	AppKey e AppSecret são inválidos	400	O AppKey e o AppSecret são inválidos.	Verifique se o AppKey e o AppSecret da solicitação estão corretos.