HTTP-Trigger (1. Generation)

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.

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 \
--no-gen2 \
--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. Weitere Informationen finden Sie unter Für Aufruf authentifizieren.
  • Das Flag --security-level steuert, ob der Funktionsendpunkt HTTPS erfordert. Der Wert secure-always bedeutet, dass HTTPS erforderlich ist und Nicht-SSL-HTTP-Anfragen nicht unterstützt. Der Wert secure-optional bedeutet, dass sowohl HTTP als auch HTTPS unterstützt werden. Der Standardwert ist secure-always.

Console

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

  1. Wählen Sie im Feld Trigger die Option HTTP aus.
  2. Wählen Sie 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.
  3. Aktivieren oder deaktivieren Sie das Kästchen HTTPS erforderlich, um zu steuern, ob für den Funktionsendpunkt HTTPS erforderlich ist. Wenn die Auswahl aufgehoben ist, werden sowohl HTTP als auch HTTPS unterstützt.

Funktions-URL

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

Cloud Run Functions-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

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

gcloud 

  gcloud functions describe YOUR_FUNCTION_NAME 

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

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