Na integração da Apigee, podem ocorrer erros quando você está testando e publicando uma integração ou durante a execução de uma integração. Esses erros podem ocorrer devido a vários problemas no lado do cliente e do servidor e são amplamente classificados da seguinte forma:
- Erros permanentes: todos os erros do lado do cliente, como falhas de autenticação e de validação de dados, são considerados permanentes. Os erros permanentes causam falhas permanentes nas tarefas.
- Erros temporários: todos os erros do lado do servidor, como HTTP 503 (serviço indisponível), HTTP 400 (solicitação inválida), são considerados erros temporários. Erros temporários causam falhas temporárias em tarefas.
As mensagens de erro aparecem nos seguintes locais:
- Registros de execução: exibe os erros encontrados durante a execução de uma integração. Cada execução de uma integração tem uma entrada de registro separada. Para informações sobre a página de registros de execução, consulte Registros de execução.
- Página do editor de integração: exibe os erros encontrados ao publicar uma integração. Os erros são exibidos na parte inferior da página do editor de integração. Para informações sobre a página do editor de integração, consulte Editor de integração.
Saiba mais sobre a lista de códigos de erro em Códigos de erro.
Métodos de tratamento de erros
A integração da Apigee oferece vários métodos de tratamento de erros para responder e se recuperar dos erros encontrados ao criar, testar, publicar ou executar suas integrações. É possível usar métodos de tratamento de erros para os modos síncrono e assíncrono de execução de integração:
-
Execuções síncronas:nesse modo, o resultado da integração fica disponível logo após a execução dela. Esse modo é útil nas situações em que você quer gerar o resultado da execução
imediatamente após a integração. Os gatilhos que executam a integração no modo síncrono incluem o seguinte:
- Testar ou publicar uma integração
- Chamar a API
projects.locations.integrations.execute - Chamar a integração de uma subintegração no modo síncrono
-
Execuções assíncronas:usam o modelo disparar e esquecer. O modo assíncrono é útil em cenários
em que as integrações podem levar muito tempo para serem executadas, ou em que o resultado da execução não é necessário
logo depois da execução. Os gatilhos que executam a integração no modo assíncrono incluem o seguinte:
- Todas as execuções não síncronas são executadas no modo assíncrono. Alguns dos modos assíncronos comuns incluem, entre outros:
- As execuções que são retomadas de uma suspensão ou uma tarefa de aprovação também são executadas no modo acirronômico, mesmo que a execução inicial tenha sido síncrona.
A integração da Apigee é compatível com os seguintes métodos de tratamento de erros para gerar, capturar, tentar novamente e personalizar os erros encontrados na integração:
Códigos de erro
A tabela a seguir descreve os erros que podem ser encontrados e as causas correspondentes para eles. A integração da Apigee usa os códigos de erro canônicos definidos em google.rpc.Code.
Para informações sobre erros de integração da Apigee e diferentes estratégias de tratamento de erros, consulte Erros e tratamento de erros.
| Tipo de exceção padrão | Código canônico | Código HTTP | Descrição |
|---|---|---|---|
| Falha de PreConditionException | FAILED_PRECONDITION |
400 | A solicitação não pode ser executada no estado atual do sistema. |
| BadRequestException | INVALID_ARGUMENT |
400 | O cliente especificou um argumento inválido. Verifique a mensagem e os detalhes do erro para mais informações. |
| UnauthenticatedException | UNAUTHENTICATED |
401 | Solicitação não autenticada devido ao token OAuth ausente, inválido ou expirado. |
| ForbiddenException | PERMISSION_DENIED |
403 | O cliente não tem permissão suficiente. Isso pode acontecer se o token OAuth não tiver os escopos certos, se o cliente não tiver as permissões necessárias ou se a API não tiver sido ativada. |
| NotFoundException | NOT_FOUND |
404 | Um recurso especificado não foi encontrado. |
| 409 - AlreadyExistsException | ALREADY_EXISTS |
409 | O recurso que um cliente tentou criar já existe. |
| InternalError | INTERNAL |
500 | Erro interno do servidor. Geralmente, um bug do servidor. Isso pode acontecer se alguma tarefa ou acionador estiver configurado incorretamente. |
| UnimplementedException | UNIMPLEMENTED |
501 | Método da API não implementado pelo servidor. |
| ServiceUnavailableException | UNAVAILABLE |
503 | Serviço indisponível. Geralmente, o servidor está desativado. |
| AbortedException | ABORTED |
409 | O tamanho da resposta é muito grande. |