Gatilhos HTTP (1ª geração)

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.

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 \
--no-gen2 \
--trigger-http \
[--allow-unauthenticated] \
[--security-level=SECURITY_LEVEL] \
...
  • A flag --trigger-http especifica que a função usa um gatilho HTTP.
  • A flag --allow-unauthenticated especifica que a função pode ser chamada sem autenticação. Omitir essa flag significa que as chamadas para a função exigem autenticação. Para mais informações, consulte Como autenticar para invocação.
  • A flag --security-level controla se o endpoint da função exige HTTPS. O valor secure-always indica que o HTTPS é necessário e que solicitações HTTP não SSL não são compatíveis. O valor secure-optional significa que HTTP e HTTPS são compatíveis. O padrão é secure-always.

Console

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

  1. No campo Tipo de gatilho, selecione HTTP.
  2. 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.
  3. Marque ou desmarque a caixa de seleção Requer HTTPS para controlar se o endpoint da função exige HTTPS. Se a opção não estiver selecionada, HTTP e HTTPS serão compatíveis.

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.

O Cloud Run functions tem 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

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

gcloud 

  gcloud functions describe YOUR_FUNCTION_NAME 

  --format="value(httpsTrigger.url)"

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