Consulte os conectores compatíveis com a Application Integration.
Erros e tratamento de erros
No Application Integration, podem ocorrer erros ao testar e publicar uma integração ou ao executar uma integração. Esses erros podem ocorrer devido a vários problemas no lado do cliente e do servidor, e são classificados amplamente da seguinte maneira:
- Erros permanentes: todos os erros do lado do cliente, como falhas de autenticação e erros de validação de dados, são considerados erros permanentes. Os erros permanentes causam falhas permanentes nas tarefas.
- Erros temporários:todos os erros do servidor, como HTTP 503 (serviço indisponível) e HTTP 400 (solicitação inválida), são considerados erros temporários. Erros temporários causam falhas de tarefa temporárias.
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 Application Integration 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. O modo síncrono é útil nos cenários em que você quer 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
- Chame 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
imediatamente após a execução da integraçã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 Application Integration é compatível com os seguintes métodos de tratamento de erros para gerar, capturar, tentar novamente e personalizar os erros encontrados na sua integração:
Códigos de erro
A tabela a seguir descreve os erros que podem ser encontrados e as causas correspondentes para eles. A Application Integration usa os códigos de erro canônicos definidos em google.rpc.Code
.
Para mais informações sobre erros do Application Integration 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 |
---|---|---|---|
FailedPreconditionException | 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. |
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. |