Acionadores do Cloud Functions

Para configurar o Cloud Functions para ser executado em resposta a vários cenários, especifique um acionador para sua função. Os gatilhos podem ser solicitações HTTP(S) ou um dos vários eventos compatíveis. Nesta página, você terá uma visão geral dos gatilhos compatíveis com o Cloud Functions.

De modo geral, os acionadores se enquadram em duas categorias:

• Acionadores HTTP, que reagem a solicitações HTTP(S) e correspondem a funções HTTP.

• Acionadores de evento, que reagem a eventos no seu projeto do Google Cloud e correspondem a funções orientadas a eventos.

Especifique gatilhos como parte da implantação da função. Não é possível vincular a mesma função a mais de um gatilho por vez, mas é possível fazer com que o mesmo evento faça com que várias funções sejam executadas implantando várias funções com as mesmas configurações de gatilho.

Observação: a vinculação do gatilho não ocorre instantaneamente. Pode levar vários minutos para que uma função implantada comece a ser acionada em eventos de entrada.

Gatilhos compatíveis com o Cloud Functions (2nd gen)

O Cloud Functions (2nd gen) é compatível com os seguintes tipos de gatilhos:

• Gatilhos HTTP
• Gatilhos de eventos:
  • Gatilhos do Pub/Sub
  • Gatilhos do Cloud Storage
  • Gatilhos generalizados do Eventarc
    • Compatível com qualquer tipo de evento aceito pelo Eventarc, incluindo mais de 90 origens de eventos usando os registros de auditoria do Cloud

Todas as funções orientadas a eventos no Cloud Functions (2nd gen) usam o Eventarc para a entrega de eventos. No Cloud Functions (2nd gen), os gatilhos do Pub/Sub e os do Cloud Storage são implementados como tipos específicos de gatilhos do Eventarc.

Observação: no momento, o Eventarc não é compatível com eventos diretos do Firestore, do Google Analytics para Firebase ou do Firebase Authentication. Use o Cloud Functions (1ª geração) para usar esses eventos.

Gatilhos compatíveis com o Cloud Functions (1ª geração)

O Cloud Functions (1ª geração) é compatível com os seguintes tipos de gatilhos:

• Gatilhos HTTP
• Gatilhos de eventos:
  • Gatilhos do Pub/Sub
  • Gatilhos do Cloud Storage
  • Gatilhos do Firestore
  • Acionadores do Google Analytics para Firebase
  • Gatilhos do Firebase Realtime Database
  • Gatilhos do Firebase Authentication
  • Gatilhos da Configuração remota do Firebase

Gatilhos adicionais via Pub/Sub e webhooks

Como o Cloud Functions pode ser acionado por mensagens em um tópico do Pub/Sub, é possível integrar o Cloud Functions a qualquer outro serviço do Google compatível com o Pub/Sub como um barramento de eventos. Além disso, com os gatilhos HTTP, também é possível fazer a integração com qualquer serviço que forneça callbacks HTTP (webhooks). As seções a seguir descrevem alguns exemplos de integração.

Cloud Logging

O Cloud Logging pode encaminhar registros para um tópico do Pub/Sub, em que eles podem ser consumidos pelo Cloud Functions. Consulte Configurar e gerenciar coletores na documentação do Cloud Logging para mais informações.

Cloud Scheduler

Os jobs do Cloud Scheduler podem enviar mensagens para um tópico do Pub/Sub, em que eles podem ser consumidos pelo Cloud Functions. Veja o tutorial do Cloud Scheduler Como usar o Pub/Sub para acionar uma função do Cloud para mais informações.

Cloud Tasks

As tarefas de destino HTTP do Cloud Tasks permitem que você execute gerenciadores de tarefas em qualquer endpoint HTTP. Portanto, uma função do Cloud com um gatilho HTTP pode ser usada como um gerenciador de tarefas. Também é possível usar tarefas para limitar invocações de função. Consulte Criar tarefas de destino HTTP na documentação do Cloud Tasks para mais informações.

Gmail

Com a API Push Notification do Gmail, é possível enviar eventos do Gmail para um tópico do Pub/Sub e consumi-los com o Cloud Functions.