HTTP-Trigger

In Cloud Run Functions ermöglicht ein HTTP-Trigger die Ausführung einer Funktion als Reaktion auf HTTP(S)-Anfragen. Wenn Sie einen HTTP-Trigger für eine Funktion angeben, wird der Funktion eine URL zugewiesen, unter der sie Anfragen empfangen kann. HTTP-Trigger unterstützen die Anfragemethoden GET, POST, PUT, DELETE und OPTIONS.

In Cloud Run Functions sind für Anfragen an eine Funktions-URL immer HTTPS erforderlich.

Standardmäßig ist für Anfragen an eine Funktion mit einem HTTP-Trigger eine Authentifizierung erforderlich. Sie können nicht authentifizierte Aufrufe während der Bereitstellung zulassen. Weitere Informationen finden Sie unter Nicht authentifizierter HTTP-Funktionsaufruf zulassen.

Mit HTTP-Funktionen implementieren Sie Cloud Run Functions-Funktionen, die allgemeine HTTP(S)-Anfragen verarbeiten können.

Bereitstellung

Sie können beim Bereitstellen einer Funktion einen HTTP-Trigger angeben. Allgemeine Anleitungen zum Bereitstellen einer Funktion finden Sie unter Cloud Run Functions-Funktion bereitstellen. In diesem Abschnitt finden Sie zusätzliche Informationen zum Konfigurieren von HTTP-Triggern während der Bereitstellung.

gcloud

Wenn Sie die gcloud CLI bereitstellen, werden die hier aufgeführten Flags zum Konfigurieren von HTTP-Triggern verwendet:

gcloud functions deploy YOUR_FUNCTION_NAME \
--trigger-http \
[--allow-unauthenticated] \
[--security-level=SECURITY_LEVEL] \
...
  • Das Flag --trigger-http gibt an, dass die Funktion einen HTTP-Trigger verwendet.
  • Das Flag --allow-unauthenticated gibt an, dass die Funktion ohne Authentifizierung aufgerufen werden kann. Wenn Sie dieses Flag weglassen, erfordert die Funktion die Authentifizierung, die Standardeinstellung ist. Weitere Informationen finden Sie unter Für Aufruf authentifizieren.

Console

Wenn Sie die Bereitstellung mit der Google Cloud Console ausführen, können Sie im Abschnitt Trigger einen HTTP-Trigger konfigurieren:

  • Wählen Sie unter HTTPS im Feld Authentifizierung eine Option aus, je nachdem, ob Sie nicht authentifizierte Aufrufe der Funktion zulassen möchten. Standardmäßig ist eine Authentifizierung erforderlich. Weitere Informationen finden Sie unter Für Aufruf authentifizieren.

Funktions-URL

Nachdem die Funktion mit einem HTTP-Trigger bereitgestellt wurde, können Sie die zugewiesene URL abrufen.

Funktionen sind URLs mit folgendem Format zugewiesen. Diese URLs haben ein deterministisches Format. Das bedeutet, dass Sie die URL vorhersagen können, bevor Sie die Funktion bereitstellen:

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

Funktionen sind außerdem eine URL zugewiesen, die dem zugrunde liegenden Cloud Run-Dienst zugeordnet ist. Diese URLs haben kein deterministisches Format. Das heißt, da das zweite Feld ein zufälliger Hash ist, können Sie nicht vorhersagen, was die URL sein wird, bevor Sie die Funktion bereitstellen. Nach der Bereitstellung der Funktion bleibt die URL stabil, aber:

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

Die cloudfunctions.net-URL und die run.app-URL einer Funktion verhalten sich genau gleich. Sie sind austauschbar.

So rufen Sie die URL(s) Ihrer Funktion ab:

gcloud 

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

Console

  1. Gehen Sie zur Übersichtsseite „Cloud Run Functions“ in der Google Cloud Console:

    Zu den Cloud Run-Funktionen

  2. Klicken Sie auf den Namen der Funktion, deren URL Sie abrufen möchten.

  3. Klicken Sie auf den Tab „Bearbeiten“.

  4. Die URL Ihrer Funktion finden Sie im Bereich Trigger.

Nächste Schritte