Acionadores HTTP (1.ª geração)

Nas funções do Cloud Run, um acionador HTTP permite que uma função seja executada em resposta a pedidos HTTP(S). Quando especifica um acionador HTTP para uma função, é atribuído um URL à função no qual pode receber pedidos. Os acionadores HTTP suportam os métodos de pedido GET, POST, PUT, DELETE e OPTIONS.

Por predefinição, os pedidos a uma função com um acionador HTTP requerem autenticação. Pode optar por permitir chamadas não autenticadas durante a implementação. Consulte o artigo Permitir a invocação de funções HTTP não autenticadas para mais informações.

Usa funções HTTP para implementar funções do Cloud Run que podem processar pedidos HTTP(S) gerais.

Implementação

Pode especificar um acionador HTTP quando implementa uma função. Consulte o artigo Implemente uma função do Cloud Run para ver instruções gerais sobre como implementar uma função, e esta secção para ver informações adicionais específicas da configuração de acionadores HTTP durante a implementação.

gcloud

Se estiver a implementar através da CLI gcloud, os sinalizadores apresentados aqui são usados para configurar acionadores 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 acionador HTTP.
  • A flag --allow-unauthenticated especifica que a função pode ser chamada sem autenticação. Omitir este sinalizador significa que as chamadas para a função requerem autenticação. Consulte o artigo Autenticação para invocação para mais informações.
  • A flag --security-level controla se o ponto final da função requer HTTPS. O valor secure-always significa que o HTTPS é obrigatório e os pedidos HTTP não SSL não são suportados. O valor secure-optional significa que o HTTP e o HTTPS são suportados. A predefinição é secure-always.

Consola

Se estiver a implementar através da Google Cloud consola, pode configurar um acionador HTTP na secção Acionador:

  1. No campo Tipo de acionador, selecione HTTP.
  2. No campo Autenticação, selecione uma opção consoante se quer permitir invocações não autenticadas da sua função. Por predefinição, a autenticação é obrigatória. Consulte o artigo Autenticação para invocação para mais informações.
  3. Selecione ou desmarque a caixa de verificação Requer HTTPS para controlar se o ponto final da função requer HTTPS. Se a opção for desmarcada, o HTTP e o HTTPS são suportados.

URL da função

Depois de implementar a função com um acionador HTTP, pode obter o URL atribuído.

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

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

Pode obter os URLs da sua função da seguinte forma:

gcloud 

  gcloud functions describe YOUR_FUNCTION_NAME 

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

Consola

  1. Aceda à página de vista geral das funções do Cloud Run na Google Cloud consola:

    Aceder às funções do Cloud Run

  2. Clique no nome da função cujo URL quer obter.

  3. Clique no separador Editar.

  4. Veja o URL da sua função na secção Acionador.

Passos seguintes