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:
    • Programar gatilho
    • Gatilho do Cloud Scheduler
    • Gatilho do Cloud Pub/Sub
    • Gatilho do Salesforce
    • Chame a API projects.locations.integrations.schedule
  • 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:

• Estratégias de tratamento de erros
• Coletor de erros

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.