Jede Ereignisquelle, jedes Ereignisziel und jeder Eventarc-Trigger hat einen eigenen Standort. Manchmal müssen diese Speicherorte übereinstimmen. Zu unterschiedlichen Zeiten können sie unterschiedlich sein. Weitere Informationen finden Sie unter Eventarc-Standorte.
Quellort
Der Standort der Ereignisquelle bestimmt häufig den Triggerstandort. Im folgenden Beispiel muss sich der Cloud Storage-Bucket in der Region europe-west1 befinden, außerdem muss sich der Trigger in europe-west1 befinden.
Beim Bereitstellen des Ereignisziels (z. B. eines Cloud Run-Dienstes) wählen Sie eine unterstützte Region als Standort aus. Aus Latenz- und Datenlokalitätsgründen sollte dies in der Regel in derselben Region wie Ihre Ereignisquelle liegen.
Dies ist jedoch nicht zwingend erforderlich. Im vorherigen Beispiel befindet sich die Ereignisquelle in europe-west1, während das Flag --destination-run-region angibt, dass sich das Ereignisziel in us-central1 befindet.
Triggerstandort
Darüber hinaus wirkt sich der Typ des erstellten Eventarc-Triggers auf den Speicherort des Triggers aus, der über das Flag --location angegeben wird:
Cloud-Audit-Logs
Mit Cloud-Audit-Log-Triggern können Sie jede Ereignisquelle, die Audit-Logs ausgibt, mit einem Ereignisziel verbinden. Cloud-Audit-Log-Trigger sind an Standorten mit einer einzigen Region verfügbar und Sie können auch einen globalen Eventarc-Trigger erstellen. Trigger werden jedoch nicht an Standorten mit zwei oder mehr Regionen unterstützt.
Der Speicherort der Ereignisquelle bestimmt den Triggerstandort. In der Regel ist dies ein Standort mit einer einzigen Region. Wenn Sie beispielsweise Cloud Storage-Ereignisse aus einem Bucket in der Region europe-west1 mit einem Audit-Log-Trigger erfassen möchten, erstellen Sie einen Trigger am selben Standort:
Da Sie keinen Bucket nach Filter filtern, wenn Sie einen Cloud-Audit-Log-Trigger verwenden, werden alle Buckets in der Region europe-west1 abgeglichen. Zum Filtern nach Bucket können Sie stattdessen einen direkten Cloud Storage-Trigger verwenden.
Für einen Bucket mit zwei Regionen oder einem multiregionalen Standort wie eu können Sie alternativ einen Trigger mit dem Standort global erstellen. Dieser stimmt mit allen Buckets in allen Regionen überein, mit denen der Ereignisfilter übereinstimmt:
Cloud Storage-Trigger reagieren auf Ereignisse in einem Cloud Storage-Bucket – Objekterstellung, Löschung, Archivierung und Metadatenaktualisierungen.
Cloud Storage-Trigger sind an Standorten mit einer Region, mit zwei Regionen und mit mehreren Regionen verfügbar. Sie können keinen globalen Eventarc-Trigger erstellen.
Der Standort des Eventarc-Triggers legt den Speicherort des Cloud Storage-Buckets fest und muss übereinstimmen. Im folgenden Beispiel entspricht der Triggerspeicherort dem des Cloud Storage-Buckets (dem multiregionalen Standort eu):
Ein Pub/Sub-Trigger verbindet ein Pub/Sub-Thema mit einem Ereignisziel. Pub/Sub-Trigger sind nur an Standorten mit einer Region verfügbar und Sie können keinen globalen Eventarc-Trigger erstellen.
Pub/Sub-Themen sind global und sind nicht an eine einzelne Region gebunden. Beim Erstellen eines Pub/Sub-Triggers müssen Sie jedoch mit dem Flag --location eine Region dafür angeben:
Eventarc konfiguriert Geofencing, damit Pub/Sub-Ereignisse nur am angegebenen Standort verbleiben. Sie können auch regionale Pub/Sub-Dienstendpunkte verwenden, um in dem Thema zu veröffentlichen, sodass alle Daten in einer einzigen Region bleiben.
Nächste Schritte
Informationen zum Weiterleiten von Ereignissen in Google Cloud -Projekten finden Sie in der Anleitung.
[[["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-18 (UTC)."],[[["\u003cp\u003eEvent source and trigger locations often need to match, such as with Cloud Storage where the bucket's region dictates the trigger's location.\u003c/p\u003e\n"],["\u003cp\u003eWhile the event target's region is typically chosen for latency and data locality, it doesn't necessarily have to be the same as the event source's region.\u003c/p\u003e\n"],["\u003cp\u003eCloud Audit Logs triggers can be created in single-region locations or globally, allowing connections to various event sources that emit audit logs.\u003c/p\u003e\n"],["\u003cp\u003eCloud Storage triggers require the trigger location to precisely match the Cloud Storage bucket's location, and they support single, dual, and multi-region locations, but not globally.\u003c/p\u003e\n"],["\u003cp\u003ePub/Sub triggers, although linked to globally accessible topics, are only available in single-region locations, and data can be confined to a single region using geofencing.\u003c/p\u003e\n"]]],[],null,["# Understand Eventarc locations\n\n[Standard](/eventarc/standard/docs/overview)\n\nEach event source, event target, and Eventarc trigger has its own\nlocation. Sometimes, these locations must match; at other times, they can be\ndifferent. For more information, see [Eventarc locations](/eventarc/docs/locations).\n\n### Source location\n\nThe location of the event source often dictates the trigger location. In the\nfollowing example, since the Cloud Storage bucket is in the `europe-west1`\nregion, the trigger must also be located in `europe-west1`. \n\n gcloud eventarc triggers create trigger-storage \\\n --destination-run-service=hello \\\n --destination-run-region=us-central1 \\\n --location=europe-west1 \\\n --event-filters=\"type=google.cloud.storage.object.v1.finalized\" \\\n --event-filters=\"bucket=my-bucket-in-europe-west1-region\" \\\n --service-account=$PROJECT_NUMBER-compute@developer.gserviceaccount.com\n\n### Target location\n\nWhen deploying your event target (for example, a Cloud Run service),\nyou choose a supported region as its location. Typically, for latency and data\nlocality reasons, you want this to be in the same region as your event source.\nHowever, it is not a requirement and in the preceding example, the event source\nis in `europe-west1` while the `--destination-run-region` flag indicates that\nthe event target is in `us-central1`.\n\n### Trigger location\n\nAdditionally, the type of Eventarc trigger you create impacts the\nlocation of the trigger which is specified through the `--location` flag: \n\n### Cloud Audit Logs\n\nUsing Cloud Audit Logs triggers, you can connect any event source that\nemits audit logs to an event target. Cloud Audit Logs triggers are\navailable in single-region locations and you can also create a global\nEventarc trigger; however, triggers are not supported in\ndual-region and multi-region locations.\n\nThe location of the event source dictates the trigger location. Typically,\nthis is a single-region location. For example, to capture Cloud Storage\nevents from a bucket in the `europe-west1` region with an audit logs trigger,\ncreate a trigger in the same location: \n\n gcloud eventarc triggers create trigger-auditlog \\\n --destination-run-service=hello \\\n --destination-run-region=us-central1 \\\n --location=europe-west1 \\\n --event-filters=\"type=google.cloud.audit.log.v1.written\" \\\n --event-filters=\"serviceName=storage.googleapis.com\" \\\n --event-filters=\"methodName=storage.objects.create\" \\\n --service-account=$PROJECT_NUMBER-compute@developer.gserviceaccount.com\n\nAs there's no filtering by bucket when you use a Cloud Audit Logs\ntrigger, this will match all buckets in the `europe-west1` region. (To filter\nby bucket, you can instead use a direct Cloud Storage trigger.)\n\nOr, to match a dual-region or multi-region bucket such as `eu`, you can\ncreate a trigger with a `global` location and this will match all buckets in\nall regions for which the event filters match: \n\n gcloud eventarc triggers create trigger-storage \\\n --destination-run-service=hello \\\n --destination-run-region=us-central1 \\\n --location=global \\\n --event-filters=\"type=google.cloud.storage.object.v1.finalized\" \\\n --event-filters=\"bucket=my-bucket-in-europe-west1-region\" \\\n --service-account=$PROJECT_NUMBER-compute@developer.gserviceaccount.com\n\n| **Note:** There is a known issue with Cloud Audit Logs triggers for [Compute Engine](/eventarc/docs/reference/supported-events#compute-engine) that results in events originating from a single region: `us-central1`. This is regardless of where the virtual machine instance is actually located. When [creating your trigger for a specific provider and destination](/eventarc/standard/docs/event-providers-targets#triggers), set the trigger location to either `us-central1` or `global`.\n\n### Cloud Storage\n\nCloud Storage triggers respond to events inside a Cloud Storage\nbucket---object creation, deletion, archiving, and metadata updates.\nCloud Storage triggers are available in single-region, dual-region,\nand multi-region locations; you cannot create a global Eventarc\ntrigger.\n\nThe location of the Cloud Storage bucket dictates the location of\nthe Eventarc trigger, and they *must* match. In the following\nexample, the trigger location matches that of the Cloud Storage\nbucket (the `eu` multi-region location): \n\n gcloud eventarc triggers create trigger-storage \\\n --destination-run-service=hello \\\n --destination-run-region=us-central1 \\\n --location=eu \\\n --event-filters=\"type=google.cloud.storage.object.v1.finalized\" \\\n --event-filters=\"bucket=my-bucket-in-eu-multi-region\" \\\n --service-account=$PROJECT_NUMBER-compute@developer.gserviceaccount.com\n\nIf the bucket and trigger regions don't match, you will see an error similar\nto the following: \n\n ERROR: (gcloud.eventarc.triggers.create) INVALID_ARGUMENT: The request was\n invalid: Bucket \"my-bucket-in-eu-multi-region\" location \"eu\" does not match\n trigger location \"europe-west1\". Try again by creating the trigger in \"eu\".\n\n### Pub/Sub\n\nA Pub/Sub trigger connects a Pub/Sub topic to\nan event target. Pub/Sub triggers are only available in\nsingle-region locations and you cannot create a global Eventarc\ntrigger.\n\nAlthough Pub/Sub topics are global and not tied to a\nsingle region, when you create a Pub/Sub trigger, you\nmust specify a region for it using the `--location` flag: \n\n gcloud eventarc triggers create trigger-pubsub \\\n --destination-run-service=hello \\\n --destination-run-region=us-central1 \\\n --location=us-central1 \\\n --event-filters=\"type=google.cloud.pubsub.topic.v1.messagePublished\" \\\n --transport-topic=projects/your-projectid/topics/your-topic\n\nEventarc configures geofencing so that Pub/Sub\nevents persist only in the specified location. You can also use regional\n[Pub/Sub service endpoints](/pubsub/docs/reference/service_apis_overview#service_endpoints)\nto publish to the topic so that all of the data stays in a single region.\n\nWhat's next\n-----------\n\n- To learn how to route events across Google Cloud projects, see the [tutorial](/eventarc/docs/cross-project-triggers)."]]
