Cloud Storage-Anleitung (1. Generation)

---

Hinweis: Dieser Inhalt gilt nur für Cloud Functions (1. Generation). Weitere Informationen finden Sie unter Versionsvergleich von Cloud Functions.

Informationen zur Version des Dokuments für die zweite Generation finden Sie in der Cloud Storage-Anleitung (2. Generation).

In dieser einfachen Anleitung wird veranschaulicht, wie eine ereignisgesteuerte Cloud Functions-Funktion erstellt, bereitgestellt und mit einem Cloud Storage-Trigger ausgelöst wird, um auf Cloud Storage-Ereignisse zu reagieren.

Hinweis: Ereignisse werden mit Pub/Sub-Benachrichtigungen aus Cloud Storage zugestellt. Der Bucket kann bis zu 10 Benachrichtigungskonfigurationen haben, die zum Auslösen von Benachrichtigungen für ein bestimmtes Ereignis festgelegt sind. Das Einrichten von zu vielen Benachrichtigungen für denselben Bucket kann das Benachrichtigungslimit für den Bucket überschreiten und das Erstellen der Funktion unmöglich machen. Dies wird durch den Fehler Cloud Storage bucket ...: Pub/Sub notification limit reached angezeigt: Wenn Sie das Limit erreicht haben, können Sie eine Funktion erst erstellen, wenn Sie entsprechende Maßnahmen ergriffen haben, z. B. Benachrichtigungen entfernen.

Codebeispiele zur Verwendung von Cloud Storage finden Sie im Google Cloud-Beispielbrowser.

Ziele

• Eine ereignisgesteuerte Cloud Functions-Funktion schreiben und bereitstellen.
• Die Funktion durch Hochladen einer Datei in Cloud Storage auslösen.

Kosten

In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:

• Cloud Functions
• Cloud Storage

Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen. Neuen Google Cloud-Nutzern steht möglicherweise eine kostenlose Testversion zur Verfügung.

---

Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt im Cloud Shell-Editor zu erhalten:

Anleitung

---

Hinweis

1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   Zur Projektauswahl

3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

4. Cloud Functions, Cloud Build, Cloud Storage, and Eventarc APIs aktivieren.

   Aktivieren Sie die APIs

5. Installieren Sie die Google Cloud CLI.

6. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:

   gcloud init

7. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

   Hinweis: Wenn Sie die Ressourcen, die Sie in diesem Verfahren erstellen, nicht behalten möchten, erstellen Sie ein Projekt, anstatt ein vorhandenes Projekt auszuwählen. Wenn Sie fertig sind, können Sie das Projekt löschen und dadurch alle mit dem Projekt verknüpften Ressourcen entfernen.

   Zur Projektauswahl

8. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

9. Cloud Functions, Cloud Build, Cloud Storage, and Eventarc APIs aktivieren.

   Aktivieren Sie die APIs

10. Installieren Sie die Google Cloud CLI.

11. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:

    gcloud init

Wenn Sie die gcloud CLI bereits installiert haben, aktualisieren Sie sie mit dem folgenden Befehl:

gcloud components update

Hinweis: Der Laufzeitdienstkontoschlüssel, den Sie für Ihre Standardanmeldedaten für Anwendungen verwenden, muss entweder die Rolle cloudfunctions.serviceAgent haben oder die Berechtigungen storage.buckets.{get, update} und resourcemanager.projects.get. Weitere Informationen zum Festlegen dieser Berechtigungen finden Sie unter Zugriff auf Ressourcen erteilen, ändern und entziehen.
12. Bereiten Sie Ihre Entwicklungsumgebung vor:

    Node.js

    Einrichtungsleitfaden für Node.js aufrufen

    Python

    Einrichtungsleitfaden für Python aufrufen

    Go

    Zum Einrichtungsleitfaden für Go

    Java

    Einrichtungsleitfaden für Java aufrufen

    C#

    Einrichtungsleitfaden für .NET aufrufen

    Ruby

    Einrichtungsleitfaden für Ruby aufrufen

    PHP

    PHP in Google Cloud verwenden

Anwendung vorbereiten

1. Erstellen Sie einen Cloud Storage-Bucket zum Hochladen einer Testdatei. Dabei sollte YOUR_TRIGGER_BUCKET_NAME ein Bucket-Name sein, der global nur einmal vorkommt:

   gsutil mb gs://YOUR_TRIGGER_BUCKET_NAME
   

2. Klonen Sie das Repository der Beispiel-App auf Ihren lokalen Computer:

   Node.js

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples.git

   Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.

   Python

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples.git

   Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.

   Einfach loslegen (Go)

   git clone https://github.com/GoogleCloudPlatform/golang-samples.git

   Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.

   Java

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples.git

   Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.

   C#

   git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples.git

   Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.

   Ruby

   git clone https://github.com/GoogleCloudPlatform/ruby-docs-samples.git

   Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.

   PHP

   git clone https://github.com/GoogleCloudPlatform/php-docs-samples.git

   Sie können auch das Beispiel als ZIP-Datei herunterladen und extrahieren.

3. Wechseln Sie in das Verzeichnis, das den Cloud Functions-Beispielcode enthält:

   Node.js

   cd nodejs-docs-samples/functions/helloworld/

   Python

   cd python-docs-samples/functions/helloworld/

   Einfach loslegen (Go)

   cd golang-samples/functions/helloworld/

   Java

   cd java-docs-samples/functions/helloworld/hello-gcs/

   C#

   cd dotnet-docs-samples/functions/helloworld/HelloGcs/

   Ruby

   cd ruby-docs-samples/functions/helloworld/storage/

   PHP

   cd php-docs-samples/functions/helloworld_storage/

Funktion bereitstellen und auslösen

Derzeit basieren Cloud Storage-Funktionen auf Pub/Sub-Benachrichtigungen von Cloud Storage und unterstützen ähnliche Ereignistypen:

• Finalize

• Delete

• Archive

• Metadata Update

In den folgenden Abschnitten erfahren Sie, wie Sie für jeden dieser Ereignistypen eine Funktion bereitstellen und auslösen.

Objekt finalisieren: Object Finalize

Object-Finalize-Ereignisse werden ausgelöst, wenn der Schreibvorgang eines Cloud Storage-Objekts erfolgreich abgeschlossen wurde. Dieses Ereignis wird also ausgelöst, wenn ein neues Objekt erstellt oder ein vorhandenes Objekt überschrieben wird. Archive- und Metadata-Update-Vorgänge werden von diesem Trigger ignoriert.

Objekt finalisieren: Funktion bereitstellen

Sehen Sie sich die Beispielfunktion zur Verarbeitung von Cloud Storage-Ereignissen an:

Node.js

/**
 * Generic background Cloud Function to be triggered by Cloud Storage.
 * This sample works for all Cloud Storage CRUD operations.
 *
 * @param {object} file The Cloud Storage file metadata.
 * @param {object} context The event metadata.
 */
exports.helloGCS = (file, context) => {
  console.log(`  Event: ${context.eventId}`);
  console.log(`  Event Type: ${context.eventType}`);
  console.log(`  Bucket: ${file.bucket}`);
  console.log(`  File: ${file.name}`);
  console.log(`  Metageneration: ${file.metageneration}`);
  console.log(`  Created: ${file.timeCreated}`);
  console.log(`  Updated: ${file.updated}`);
};

Python

def hello_gcs(event, context):
    """Background Cloud Function to be triggered by Cloud Storage.
       This generic function logs relevant data when a file is changed,
       and works for all Cloud Storage CRUD operations.
    Args:
        event (dict):  The dictionary with data specific to this type of event.
                       The `data` field contains a description of the event in
                       the Cloud Storage `object` format described here:
                       https://cloud.google.com/storage/docs/json_api/v1/objects#resource
        context (google.cloud.functions.Context): Metadata of triggering event.
    Returns:
        None; the output is written to Cloud Logging
    """

    print(f"Event ID: {context.event_id}")
    print(f"Event type: {context.event_type}")
    print("Bucket: {}".format(event["bucket"]))
    print("File: {}".format(event["name"]))
    print("Metageneration: {}".format(event["metageneration"]))
    print("Created: {}".format(event["timeCreated"]))
    print("Updated: {}".format(event["updated"]))

Einfach loslegen (Go)

// Package helloworld provides a set of Cloud Functions samples.
package helloworld

import (
	"context"
	"fmt"
	"log"
	"time"

	"cloud.google.com/go/functions/metadata"
)

// GCSEvent is the payload of a GCS event.
type GCSEvent struct {
	Kind                    string                 `json:"kind"`
	ID                      string                 `json:"id"`
	SelfLink                string                 `json:"selfLink"`
	Name                    string                 `json:"name"`
	Bucket                  string                 `json:"bucket"`
	Generation              string                 `json:"generation"`
	Metageneration          string                 `json:"metageneration"`
	ContentType             string                 `json:"contentType"`
	TimeCreated             time.Time              `json:"timeCreated"`
	Updated                 time.Time              `json:"updated"`
	TemporaryHold           bool                   `json:"temporaryHold"`
	EventBasedHold          bool                   `json:"eventBasedHold"`
	RetentionExpirationTime time.Time              `json:"retentionExpirationTime"`
	StorageClass            string                 `json:"storageClass"`
	TimeStorageClassUpdated time.Time              `json:"timeStorageClassUpdated"`
	Size                    string                 `json:"size"`
	MD5Hash                 string                 `json:"md5Hash"`
	MediaLink               string                 `json:"mediaLink"`
	ContentEncoding         string                 `json:"contentEncoding"`
	ContentDisposition      string                 `json:"contentDisposition"`
	CacheControl            string                 `json:"cacheControl"`
	Metadata                map[string]interface{} `json:"metadata"`
	CRC32C                  string                 `json:"crc32c"`
	ComponentCount          int                    `json:"componentCount"`
	Etag                    string                 `json:"etag"`
	CustomerEncryption      struct {
		EncryptionAlgorithm string `json:"encryptionAlgorithm"`
		KeySha256           string `json:"keySha256"`
	}
	KMSKeyName    string `json:"kmsKeyName"`
	ResourceState string `json:"resourceState"`
}

// HelloGCS consumes a(ny) GCS event.
func HelloGCS(ctx context.Context, e GCSEvent) error {
	meta, err := metadata.FromContext(ctx)
	if err != nil {
		return fmt.Errorf("metadata.FromContext: %w", err)
	}
	log.Printf("Event ID: %v\n", meta.EventID)
	log.Printf("Event type: %v\n", meta.EventType)
	log.Printf("Bucket: %v\n", e.Bucket)
	log.Printf("File: %v\n", e.Name)
	log.Printf("Metageneration: %v\n", e.Metageneration)
	log.Printf("Created: %v\n", e.TimeCreated)
	log.Printf("Updated: %v\n", e.Updated)
	return nil
}

Java

import com.google.cloud.functions.BackgroundFunction;
import com.google.cloud.functions.Context;
import functions.eventpojos.GcsEvent;
import java.util.logging.Logger;

/**
 * Example Cloud Storage-triggered function.
 * This function can process any event from Cloud Storage.
 */
public class HelloGcs implements BackgroundFunction<GcsEvent> {
  private static final Logger logger = Logger.getLogger(HelloGcs.class.getName());

  @Override
  public void accept(GcsEvent event, Context context) {
    logger.info("Event: " + context.eventId());
    logger.info("Event Type: " + context.eventType());
    logger.info("Bucket: " + event.getBucket());
    logger.info("File: " + event.getName());
    logger.info("Metageneration: " + event.getMetageneration());
    logger.info("Created: " + event.getTimeCreated());
    logger.info("Updated: " + event.getUpdated());
  }
}

C#

using CloudNative.CloudEvents;
using Google.Cloud.Functions.Framework;
using Google.Events.Protobuf.Cloud.Storage.V1;
using Microsoft.Extensions.Logging;
using System.Threading;
using System.Threading.Tasks;

namespace HelloGcs;

 /// <summary>
 /// Example Cloud Storage-triggered function.
 /// This function can process any event from Cloud Storage.
 /// </summary>
public class Function : ICloudEventFunction<StorageObjectData>
{
    private readonly ILogger _logger;

    public Function(ILogger<Function> logger) =>
        _logger = logger;

    public Task HandleAsync(CloudEvent cloudEvent, StorageObjectData data, CancellationToken cancellationToken)
    {
        _logger.LogInformation("Event: {event}", cloudEvent.Id);
        _logger.LogInformation("Event Type: {type}", cloudEvent.Type);
        _logger.LogInformation("Bucket: {bucket}", data.Bucket);
        _logger.LogInformation("File: {file}", data.Name);
        _logger.LogInformation("Metageneration: {metageneration}", data.Metageneration);
        _logger.LogInformation("Created: {created:s}", data.TimeCreated?.ToDateTimeOffset());
        _logger.LogInformation("Updated: {updated:s}", data.Updated?.ToDateTimeOffset());
        return Task.CompletedTask;
    }
}

Ruby

require "functions_framework"

FunctionsFramework.cloud_event "hello_gcs" do |event|
  # This function supports all Cloud Storage events.
  # The `event` parameter is a CloudEvents::Event::V1 object.
  # See https://cloudevents.github.io/sdk-ruby/latest/CloudEvents/Event/V1.html
  payload = event.data

  logger.info "Event: #{event.id}"
  logger.info "Event Type: #{event.type}"
  logger.info "Bucket: #{payload['bucket']}"
  logger.info "File: #{payload['name']}"
  logger.info "Metageneration: #{payload['metageneration']}"
  logger.info "Created: #{payload['timeCreated']}"
  logger.info "Updated: #{payload['updated']}"
end

PHP

use CloudEvents\V1\CloudEventInterface;
use Google\CloudFunctions\FunctionsFramework;

// Register the function with Functions Framework.
// This enables omitting the `FUNCTIONS_SIGNATURE_TYPE=cloudevent` environment
// variable when deploying. The `FUNCTION_TARGET` environment variable should
// match the first parameter.
FunctionsFramework::cloudEvent('helloGCS', 'helloGCS');

function helloGCS(CloudEventInterface $cloudevent)
{
    // This function supports all Cloud Storage event types.
    $log = fopen(getenv('LOGGER_OUTPUT') ?: 'php://stderr', 'wb');
    $data = $cloudevent->getData();
    fwrite($log, 'Event: ' . $cloudevent->getId() . PHP_EOL);
    fwrite($log, 'Event Type: ' . $cloudevent->getType() . PHP_EOL);
    fwrite($log, 'Bucket: ' . $data['bucket'] . PHP_EOL);
    fwrite($log, 'File: ' . $data['name'] . PHP_EOL);
    fwrite($log, 'Metageneration: ' . $data['metageneration'] . PHP_EOL);
    fwrite($log, 'Created: ' . $data['timeCreated'] . PHP_EOL);
    fwrite($log, 'Updated: ' . $data['updated'] . PHP_EOL);
}

Zum Bereitstellen der Funktion führen Sie den folgenden Befehl in dem Verzeichnis aus, in dem sich der Beispielcode befindet:

Node.js

gcloud functions deploy helloGCS \
--runtime nodejs20 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.finalize

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Node.js-Version anzugeben und die Funktion auszuführen.

Python

gcloud functions deploy hello_gcs \
--runtime python312 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.finalize

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Python-Version anzugeben und die Funktion auszuführen.

Einfach loslegen (Go)

gcloud functions deploy HelloGCS \
--runtime go121 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.finalize

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Go-Version anzugeben und die Funktion auszuführen.

Java

gcloud functions deploy java-gcs-function \
--entry-point functions.HelloGcs \
--runtime java17 \
--memory 512MB \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.finalize

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Java-Version anzugeben und die Funktion auszuführen.

C#

gcloud functions deploy csharp-gcs-function \
--entry-point HelloGcs.Function \
--runtime dotnet6 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.finalize

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten .NET-Version anzugeben, um Ihre Funktion auszuführen.

Ruby

gcloud functions deploy hello_gcs --runtime ruby32 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.finalize

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Ruby-Version anzugeben, um die Funktion auszuführen.

PHP

 gcloud functions deploy helloGCS --runtime php82 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.finalize

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten PHP-Version anzugeben, um die Funktion auszuführen.

Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, der die Funktion auslöst.

Objekt finalisieren: Funktion auslösen

So lösen Sie die Funktion aus:

1. Erstellen Sie eine leere Datei gcf-test.txt in dem Verzeichnis, in dem sich der Beispielcode befindet.

2. Laden Sie die Datei in Cloud Storage hoch, um die Funktion auszulösen:

   gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
   

   Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, in den die Testdatei hochgeladen werden soll.

3. Prüfen Sie anhand der Logs, ob die Vorgänge abgeschlossen wurden:

   gcloud functions logs read --limit 50
   

Objekt löschen: Object Delete

Object-Delete-Ereignisse sind besonders nützlich für Buckets ohne Versionsverwaltung. Sie werden ausgelöst, wenn eine alte Version eines Objekts gelöscht wird. Außerdem werden sie ausgelöst, wenn ein Objekt überschrieben wird. Object-Delete-Trigger können auch mit Buckets mit Versionsverwaltung verwendet werden. Sie werden ausgelöst, wenn eine Version eines Objekts endgültig gelöscht wird.

Objekt löschen: Funktion bereitstellen

Verwenden Sie denselben Beispielcode wie im Finalize-Beispiel, um die Funktion mit dem Triggerereignis "Object Delete" bereitzustellen. Führen Sie den folgenden Befehl in dem Verzeichnis aus, in dem sich der Beispielcode befindet:

Node.js

gcloud functions deploy helloGCS \
--runtime nodejs20 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.delete

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Node.js-Version anzugeben und die Funktion auszuführen.

Python

gcloud functions deploy hello_gcs \
--runtime python312 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.delete

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Python-Version anzugeben und die Funktion auszuführen.

Einfach loslegen (Go)

gcloud functions deploy HelloGCS \
--runtime go121 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.delete

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Go-Version anzugeben und die Funktion auszuführen.

Java

gcloud functions deploy java-gcs-function \
--entry-point functions.HelloGcs \
--runtime java17 \
--memory 512MB \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.delete

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Java-Version anzugeben und die Funktion auszuführen.

C#

gcloud functions deploy csharp-gcs-function \
--entry-point HelloGcs.Function \
--runtime dotnet6 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.delete

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten .NET-Version anzugeben, um Ihre Funktion auszuführen.

Ruby

gcloud functions deploy hello_gcs --runtime ruby32 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.delete

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Ruby-Version anzugeben, um die Funktion auszuführen.

PHP

 gcloud functions deploy helloGCS --runtime php82 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.delete

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten PHP-Version anzugeben, um die Funktion auszuführen.

Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, der die Funktion auslöst.

Objekt löschen: Funktion auslösen

So lösen Sie die Funktion aus:

1. Erstellen Sie eine leere Datei gcf-test.txt in dem Verzeichnis, in dem sich der Beispielcode befindet.

2. Prüfen Sie, ob die Versionsverwaltung des Buckets deaktiviert ist:

   gsutil versioning set off gs://YOUR_TRIGGER_BUCKET_NAME
   

3. Laden Sie die Datei in Cloud Storage hoch:

   gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
   

   Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, in den die Testdatei hochgeladen werden soll. An diesem Punkt sollte die Funktion noch nicht ausgeführt werden.

4. Löschen Sie die Datei, um die Funktion auszulösen:

   gsutil rm gs://YOUR_TRIGGER_BUCKET_NAME/gcf-test.txt
   

5. Prüfen Sie anhand der Logs, ob die Vorgänge abgeschlossen wurden:

   gcloud functions logs read --limit 50
   

Die Ausführung der Funktion kann einige Zeit in Anspruch nehmen.

Objekt archivieren: Object Archive

Object-Archive-Ereignisse können nur mit Buckets mit Versionsverwaltung verwendet werden. Sie werden ausgelöst, wenn eine alte Version eines Objekts archiviert wird. Ein Archive-Ereignis wird also ausgelöst, wenn ein Objekt überschrieben oder gelöscht wird.

Objekt archivieren: Funktion bereitstellen

Verwenden Sie denselben Beispielcode wie im Finalize-Beispiel, um die Funktion mit dem Triggerereignis "Object Archive" bereitzustellen. Führen Sie den folgenden Befehl in dem Verzeichnis aus, in dem sich der Beispielcode befindet:

Node.js

gcloud functions deploy helloGCS \
--runtime nodejs20 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.archive

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Node.js-Version anzugeben und die Funktion auszuführen.

Python

gcloud functions deploy hello_gcs \
--runtime python312 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.archive

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Python-Version anzugeben und die Funktion auszuführen.

Einfach loslegen (Go)

gcloud functions deploy HelloGCS \
--runtime go121 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.archive

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Go-Version anzugeben und die Funktion auszuführen.

Java

gcloud functions deploy java-gcs-function \
--entry-point functions.HelloGcs \
--runtime java17 \
--memory 512MB \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.archive

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Java-Version anzugeben und die Funktion auszuführen.

C#

gcloud functions deploy csharp-gcs-function \
--entry-point HelloGcs.Function \
--runtime dotnet6 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.archive

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten .NET-Version anzugeben, um Ihre Funktion auszuführen.

Ruby

gcloud functions deploy hello_gcs --runtime ruby32 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.archive

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Ruby-Version anzugeben, um die Funktion auszuführen.

PHP

 gcloud functions deploy helloGCS --runtime php82 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.archive

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten PHP-Version anzugeben, um die Funktion auszuführen.

Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, der die Funktion auslöst.

Objekt archivieren: Funktion auslösen

So lösen Sie die Funktion aus:

1. Erstellen Sie eine leere Datei gcf-test.txt in dem Verzeichnis, in dem sich der Beispielcode befindet.

2. Prüfen Sie, ob die Versionsverwaltung des Buckets aktiviert ist:

   gsutil versioning set on gs://YOUR_TRIGGER_BUCKET_NAME
   

3. Laden Sie die Datei in Cloud Storage hoch:

   gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
   

   Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, in den die Testdatei hochgeladen werden soll. An diesem Punkt sollte die Funktion noch nicht ausgeführt werden.

4. Archivieren Sie die Datei, um die Funktion auszulösen:

   gsutil rm gs://YOUR_TRIGGER_BUCKET_NAME/gcf-test.txt
   

5. Prüfen Sie anhand der Logs, ob die Vorgänge abgeschlossen wurden:

   gcloud functions logs read --limit 50
   

Objektmetadaten aktualisieren: Object Metadata Update

Object-Metadata-Update-Ereignisse werden ausgelöst, wenn die Metadaten vorhandener Objekte aktualisiert werden.

Objektmetadaten aktualisieren: Funktion bereitstellen

Verwenden Sie denselben Beispielcode wie im Finalize-Beispiel, um die Funktion mit dem Triggerereignis "Metadata Update" bereitzustellen. Führen Sie den folgenden Befehl in dem Verzeichnis aus, in dem sich der Beispielcode befindet:

Node.js

gcloud functions deploy helloGCS \
--runtime nodejs20 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.metadataUpdate

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Node.js-Version anzugeben und die Funktion auszuführen.

Python

gcloud functions deploy hello_gcs \
--runtime python312 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.metadataUpdate

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Python-Version anzugeben und die Funktion auszuführen.

Einfach loslegen (Go)

gcloud functions deploy HelloGCS \
--runtime go121 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.metadataUpdate

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Go-Version anzugeben und die Funktion auszuführen.

Java

gcloud functions deploy java-gcs-function \
--entry-point functions.HelloGcs \
--runtime java17 \
--memory 512MB \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.metadataUpdate

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Java-Version anzugeben und die Funktion auszuführen.

C#

gcloud functions deploy csharp-gcs-function \
--entry-point HelloGcs.Function \
--runtime dotnet6 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.metadataUpdate

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten .NET-Version anzugeben, um Ihre Funktion auszuführen.

Ruby

gcloud functions deploy hello_gcs --runtime ruby32 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.metadataUpdate

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten Ruby-Version anzugeben, um die Funktion auszuführen.

PHP

 gcloud functions deploy helloGCS --runtime php82 \
--trigger-resource YOUR_TRIGGER_BUCKET_NAME \
--trigger-event google.storage.object.metadataUpdate

Verwenden Sie das Flag --runtime, um die Laufzeit-ID einer unterstützten PHP-Version anzugeben, um die Funktion auszuführen.

Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, der die Funktion auslöst.

Objektmetadaten aktualisieren: Funktion auslösen

So lösen Sie die Funktion aus:

1. Erstellen Sie eine leere Datei gcf-test.txt in dem Verzeichnis, in dem sich der Beispielcode befindet.

2. Prüfen Sie, ob die Versionsverwaltung des Buckets deaktiviert ist:

   gsutil versioning set off gs://YOUR_TRIGGER_BUCKET_NAME
   

3. Laden Sie die Datei in Cloud Storage hoch:

   gsutil cp gcf-test.txt gs://YOUR_TRIGGER_BUCKET_NAME
   

   Dabei ist YOUR_TRIGGER_BUCKET_NAME der Name des Cloud Storage-Buckets, in den die Testdatei hochgeladen werden soll. An diesem Punkt sollte die Funktion noch nicht ausgeführt werden.

4. Aktualisieren Sie die Metadaten der Datei:

   gsutil -m setmeta -h "Content-Type:text/plain" gs://YOUR_TRIGGER_BUCKET_NAME/gcf-test.txt
   

5. Prüfen Sie anhand der Logs, ob die Vorgänge abgeschlossen wurden:

   gcloud functions logs read --limit 50
   

Bereinigen

Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, löschen Sie entweder das Projekt, das die Ressourcen enthält, oder Sie behalten das Projekt und löschen die einzelnen Ressourcen.

Projekt löschen

Am einfachsten vermeiden Sie weitere Kosten, wenn Sie das zum Ausführen der Anleitung erstellte Projekt löschen.

So löschen Sie das Projekt:

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.

Wenn Sie mehrere Architekturen, Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, indem Sie Projekte wiederverwenden.

1. Wechseln Sie in der Google Cloud Console zur Seite Ressourcen verwalten.

   Zur Seite „Ressourcen verwalten“

2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Shut down (Beenden), um das Projekt zu löschen.

Cloud Functions-Funktion löschen

Durch das Löschen von Cloud Functions-Funktionen werden keine in Cloud Storage gespeicherten Ressourcen entfernt.

Führen Sie den folgenden Befehl aus, um die in dieser Anleitung erstellte Cloud Functions-Funktion zu löschen:

Node.js

gcloud functions delete helloGCS 

Python

gcloud functions delete hello_gcs 

Einfach loslegen (Go)

gcloud functions delete HelloGCS 

Java

gcloud functions delete java-gcs-function 

C#

gcloud functions delete csharp-gcs-function 

Ruby

gcloud functions delete hello_gcs 

PHP

gcloud functions delete helloGCS 

Sie können Cloud Functions-Funktionen auch über die Google Cloud Console löschen.

Nächste Schritte

• Weitere Informationen zum Ausführen von OCR für Bilder, die in einen Bucket hochgeladen wurden.
• Textdateien mit Cloud Functions übersetzen.