Gatilhos HTTP

No Cloud Run functions, um gatilho HTTP permite que uma função seja executada em resposta a solicitações HTTP(S). Quando você especifica um gatilho HTTP para uma função, um URL para receber solicitações é atribuído a ela. Os gatilhos de HTTP oferecem suporte aos métodos de solicitação GET, POST, PUT, DELETE e OPTIONS.

Nas funções do Cloud Run, as solicitações para um URL de função sempre exigem HTTPS.

Por padrão, as solicitações para uma função com um gatilho HTTP exigem autenticação. É possível permitir chamadas não autenticadas durante a implantação. Consulte Como permitir a invocação de funções HTTP não autenticadas.

Use funções HTTP para implementar o Cloud Run functions que podem processar solicitações HTTP(S) gerais.

Implantação

É possível especificar um gatilho HTTP ao implantar uma função. Consulte Implantar o Cloud Run functions com instruções gerais sobre como implantar uma função e esta seção com mais informações específicas para configurar gatilhos HTTP durante a implantação.

gcloud

Se você estiver implantando com a gcloud CLI, as flags mostradas aqui serão usadas para configurar os gatilhos HTTP.

gcloud functions deploy YOUR_FUNCTION_NAME \
--trigger-http \
[--allow-unauthenticated] \
[--security-level=SECURITY_LEVEL] \
...

Console

Para implantar usando o console do Google Cloud, configure um gatilho HTTP na seção Gatilho:

  • Em HTTPS, no campo Autenticação, selecione uma opção se quiser permitir invocações não autenticadas da sua função. Por padrão, a autenticação é obrigatória. Para mais informações, consulte Como autenticar para invocação.

URL da função

Após a implantação da função com um gatilho HTTP, é possível recuperar o URL atribuído a ela.

As funções têm URLs atribuídos com o seguinte formato. Esses URLs têm um formato determinístico, o que significa que você pode prever qual será o URL antes de implantar a função:

https://REGION-PROJECT_ID.cloudfunctions.net/FUNCTION_NAME

As funções também têm um URL atribuído associado ao serviço subjacente do Cloud Run. Esses URLs não têm um formato determinístico, o que significa que, como o segundo campo é um hash aleatório, não é possível prever qual será o URL antes de implantar a função. Depois de implantar a função, o URL permanecerá estável:

https://FUNCTION_NAME-RANDOM_HASH-REGION.a.run.app

O URL cloudfunctions.net e o URL run.app de uma função vão se comportar da mesma maneira. Eles são intercambiáveis.

É possível recuperar os URLs da função da seguinte maneira:

gcloud 

gcloud functions describe YOUR_FUNCTION_NAME \
--region=YOUR_FUNCTION_REGION \
--format="value(serviceConfig.uri)" \
...

Console

  1. Acesse a página de visão geral das funções do Cloud Run no console do Google Cloud.

    Acessar as funções do Cloud Run

  2. Clique no nome da função com o URL que você quer recuperar.

  3. Clique na guia "Editar".

  4. Veja o URL da função na seção Gatilho.

Próximas etapas