Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Funktionen verwalten
In dieser Anleitung erfahren Sie, wie Sie eine Funktion verwalten und trennen, die mit dem Befehl gcloud functions erstellt wurde. Informationen zum Verwalten einer Funktion, die mit dem Befehl gcloud run erstellt wurde, finden Sie unter Cloud Run-Dienste verwalten.
Funktionen, die mit der Cloud Functions API v2 erstellt wurden (z. B. mit gcloud functions, der REST API oder Terraform), können sowohl mit der Cloud Run Admin API als auch mit der Cloud Functions API v2 verwaltet werden. Sie können beispielsweise eine vorhandene Funktion mit den Befehlen gcloud functions oder gcloud run aktualisieren:
gcloud run deploy FUNCTION_NAME \
--source= . \
--function=ENTRYPOINT
--base-image=google-22-full/nodejs22
Trennen
Mit dem Befehl gcloud functions detach können Sie eine Cloud Functions V2-Funktion von ihrer vorhandenen API-Umgebung trennen. Nachdem Sie eine Funktion getrennt haben, können Sie sie nur noch über die Cloud Run Admin API verwalten. Dies kann sinnvoll sein, wenn Ihre Arbeitslasten innerhalb der run.googleapis.com API-Grenze für Assured Workloads bleiben müssen oder wenn Sie dafür sorgen möchten, dass Ihre Arbeitslasten die Cloud Run-SKU verwenden.
Funktion für das Trennen vorbereiten
Beachten Sie bei der Vorbereitung der Deaktivierung Ihrer Funktion Folgendes:
Dieser Vorgang kann nicht rückgängig gemacht werden.
Der Vorgang „Trennen“ kann nicht auf Cloud Run Functions der 1. Generation angewendet werden.
Informieren Sie sich darüber, wie Sie Funktionen in Cloud Run bereitstellen, indem Sie die Google Cloud Console, die Google Cloud CLI und Terraform verwenden.
HTTP-Funktionen behalten ihre zugewiesenen URLs.
Trigger, die an ereignisgesteuerte Funktionen angehängt sind, bleiben erhalten.
Trigger können nicht direkt über die run.googleapis.com API verwaltet werden.
Lesen Sie sich die Anleitungen zur Triggerverwaltung für Eventarc oder Pub/Sub durch.
Während des Entkoppelungsvorgangs werden die Trigger geändert, die mit Funktionen verknüpft sind, die mit no retry on failure (Bei Fehler keine Wiederholung) konfiguriert sind. So wird sichergestellt, dass für das zugrunde liegende Pub/Sub-Thema maximal fünf Übermittlungsversuche unternommen werden. Wenn der Vorgang abgeschlossen ist, werden die nicht zugestellten Nachrichten in einem Thema für Dead-Letter-Warteschlangen gespeichert. Sie können sie abrufen, indem Sie ein neues Abo für die Dead-Letter-Warteschlange erstellen.
Wenn eine Funktion erfolgreich getrennt wurde, wird eine neue Cloud Run-Überarbeitung erstellt. Ab dieser Version wird die Funktion mit der Cloud Run-SKU abgerechnet.
Funktion trennen
Sie können die Funktion mit dem folgenden Befehl trennen:
gcloud functions detach FUNCTION_NAME
Ersetzen Sie FUNCTION_NAME durch den Namen Ihrer Funktion.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-19 (UTC)."],[[["\u003cp\u003eCloud Functions v2 API functions can be managed using either the Cloud Functions v2 API or the Cloud Run Admin API, allowing for flexibility in deployment and updates via \u003ccode\u003egcloud functions\u003c/code\u003e or \u003ccode\u003egcloud run\u003c/code\u003e commands.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egcloud beta functions detach\u003c/code\u003e command enables the detachment of a Cloud Functions v2 function from its original API environment, transitioning its management exclusively to the Cloud Run Admin API.\u003c/p\u003e\n"],["\u003cp\u003eDetaching a function is irreversible and not applicable to Cloud Run (1st gen) functions, but HTTP functions retain their URLs and event-driven functions retain triggers.\u003c/p\u003e\n"],["\u003cp\u003eDetaching a function to the Cloud Run Admin API changes the billing to the Cloud Run SKU, and modifies the retry settings for event-driven functions to ensure a maximum of five delivery attempts with the use of a dead letter queue for undelivered messages.\u003c/p\u003e\n"],["\u003cp\u003eFollowing a successful detach operation, a new Cloud Run revision of the function is created, marking the point from which the function will be managed and billed through the Cloud Run framework.\u003c/p\u003e\n"]]],[],null,["# Manage functions\n================\n\nThis guide shows you how to manage and detach a function that was created with\nthe `gcloud functions` command. To learn how to manage a function that was\ncreated with the `gcloud run` command, see [Manage Cloud Run services](/run/docs/managing/services).\n| **Note:** If you created a Cloud Run function using `gcloud run` commands or the Cloud Run Admin API, you can't manage that function with `gcloud functions` commands or the Cloud Functions v2 API.\n\nFunctions created using the [Cloud Functions v2 API](/functions/docs/apis)\n(for example, by using `gcloud functions`, the REST API, or Terraform) can be\nmanaged with the [Cloud Run Admin API](/run/docs/reference/cloud-run-admin-api-overview)\nas well as the Cloud Functions v2 API. For example, you can update an\nexisting function using either `gcloud functions` or `gcloud run` commands: \n\n### gcloud functions\n\n gcloud functions deploy \u003cvar translate=\"no\"\u003eFUNCTION_NAME\u003c/var\u003e \\\n --runtime=nodejs22 \\\n --source= . \\\n --entry-point=\u003cvar translate=\"no\"\u003eENTRYPOINT\u003c/var\u003e\n --trigger-http\n\n### gcloud run\n\n gcloud run deploy \u003cvar translate=\"no\"\u003eFUNCTION_NAME\u003c/var\u003e \\\n --source= . \\\n --function=\u003cvar translate=\"no\"\u003eENTRYPOINT\u003c/var\u003e\n --base-image=google-22-full/nodejs22\n\nDetach\n------\n\nThe [`gcloud functions detach`](/sdk/gcloud/reference/functions/detach)\ncommand lets you detach a Cloud Functions v2 function from its existing\nAPI environment. After you detach a function, you can only manage it using the\nCloud Run Admin API. You might want to do this if your workloads need to stay\nwithin the `run.googleapis.com` API boundary for\n[Assured Workloads](/assured-workloads/docs/overview), or to ensure\nthat your workloads use the [Cloud Run SKU](/skus/sku-groups/cloud-run).\n\n### Prepare your function for detach\n\nWhen preparing to detach your function, consider the following:\n\n- The detach operation is not reversible.\n- The detach operation cannot be applied to Cloud Run functions (1st gen).\n- Familiarize yourself with how to [deploy functions in Cloud Run](/run/docs/deploy-functions) using the Google Cloud console, Google Cloud CLI, and Terraform.\n- HTTP functions will retain their assigned URLs.\n- Triggers attached to event-driven functions will be retained.\n- Triggers cannot be managed through the `run.googleapis.com` API directly. Be sure to familiarize yourself with the trigger management guides for [Eventarc](/eventarc/docs) or [Pub/Sub](/pubsub/docs/overview).\n- Disabling [retry on failure](/functions/docs/bestpractices/retries#event_driven_functions_created_with_v2_api) is not a supported feature on Cloud Run.\n - During the detach operation, Cloud Run functions modifies the triggers attached to functions configured with [no retry on failure](/functions/docs/bestpractices/retries#event_driven_functions_created_with_v2_api), to ensure that the underlying Pub/Sub topic makes a maximum of five delivery attempts. When the detach operation is completed, a [dead letter queue](/pubsub/docs/handling-failures#how_dead_letter_topics_work) topic stores the undelivered messages, which you can retrieve by creating a new subscription to the dead letter queue.\n- When a function is successfully detached, a new Cloud Run revision is created. Starting from that revision onwards, the function will be billed using the [Cloud Run SKU](/skus/sku-groups/cloud-run).\n\n### Detach your function\n\nYou can detach your function using the following command: \n\n gcloud functions detach \u003cvar translate=\"no\"\u003eFUNCTION_NAME\u003c/var\u003e\n\nReplace \u003cvar translate=\"no\"\u003eFUNCTION_NAME\u003c/var\u003e with the name of your function."]]
