本頁面由 Cloud Translation API 翻譯而成。

管理觸發條件

標準

您可以在終端機或 Cloud Shell 中，使用 Google Cloud 控制台或 Google Cloud CLI 來管理觸發事件。你也可以透過 Eventarc API 管理觸發條件。

列出觸發條件

您可以列出、篩選及排序所有位置的觸發事件。

控制台

在 Google Cloud 控制台中，前往「Eventarc」「Triggers」(觸發條件) 頁面。

前往「Triggers」(觸發條件)

這份清單會列出專案中所有位置的所有觸發事件，並包含觸發事件名稱、區域、事件供應者、目的地和事件類型等詳細資料。
如要依特定資源篩選觸發條件，請按照下列步驟操作：
1. 按一下「篩選器」方塊。
2. 從「資源」清單中選取篩選觸發事件的選項，例如「名稱」或「事件管道」。
您可以選取單一屬性，或使用邏輯運算子 OR 新增更多篩選屬性。
如要排序觸發事件，請按一下相應欄標題旁的「排序」。

只有部分資料欄可排序，例如「名稱」、「地區」或「事件管道」。

gcloud

gcloud eventarc triggers list --location=-

這個指令會列出所有位置的觸發事件名稱、類型、目的地和狀態。

REST

如要列出特定專案和位置中的觸發事件，請使用 projects.locations.triggers.list 方法。

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：您的 Google Cloud專案 ID。
LOCATION：建立觸發條件的區域，例如 us-central1。

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

注意：以下指令假設您已使用使用者帳戶登入 gcloud CLI，方法是執行 gcloud init 或 gcloud auth login，或是使用 Cloud Shell，後者會自動登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/triggers"

PowerShell (Windows)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/triggers" | Select-Object -Expand Content

如果成功，回應主體會包含 Trigger 的例項，回應應類似於以下內容：

{
  "triggers": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/triggers/TRIGGER_NAME",
      "uid": "d700773a-698b-47b2-a712-2ee10b690062",
      "createTime": "2022-12-06T22:44:04.744001514Z",
      "updateTime": "2022-12-06T22:44:09.116459550Z",
      "eventFilters": [
        {
          "attribute": "type",
          "value": "google.cloud.pubsub.topic.v1.messagePublished"
        }
      ],
      "serviceAccount": "SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com",
      "destination": {
        "workflow": "projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_NAME"
      },
      "transport": {
        "pubsub": {
          "topic": "projects/PROJECT_ID/topics/TOPIC_ID",
          "subscription": "projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID"
        }
      }
    },
    {
      object (Trigger)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}

說明觸發條件

您可以描述特定位置的觸發條件。

控制台

在 Google Cloud 控制台中，前往「Eventarc」「Triggers」(觸發條件) 頁面。

前往「Triggers」(觸發條件)
在觸發條件清單中，按一下您想瞭解詳細資料的觸發條件。

「觸發事件詳細資料」頁面會顯示觸發事件的詳細資料，例如名稱、區域、事件供應器、事件類型、事件資料內容類型和目的地。

gcloud

gcloud eventarc triggers describe TRIGGER \
    --location=LOCATION

更改下列內容：

TRIGGER：觸發條件 ID 或完整修飾 ID。
LOCATION：Eventarc 觸發條件的所在位置。

這個指令會傳回觸發事件的相關資訊，類似以下內容：

  createTime: '2023-03-16T13:40:44.889670204Z'
  destination:
    cloudRun:
      path: /
      region: us-central1
      service: hello
  eventDataContentType: application/protobuf
  eventFilters:
  - attribute: serviceName
    value: cloudscheduler.googleapis.com
  - attribute: methodName
    value: google.cloud.scheduler.v1.CloudScheduler.DeleteJob
  - attribute: type
    value: google.cloud.audit.log.v1.written
  name: projects/project-name/locations/us-central1/triggers/name-of-trigger
  serviceAccount: project-number-compute@developer.gserviceaccount.com
  transport:
    pubsub:
      subscription: projects/project-name/subscriptions/eventarc-us-central1-name-of-trigger-sub-034
      topic: projects/project-name/topics/eventarc-us-central1-name-of-trigger-931

REST

如要說明特定專案和位置中的觸發事件，請使用 projects.locations.triggers.get 方法。

使用任何要求資料之前，請先替換以下項目：

TRIGGER_NAME：您要說明的觸發條件名稱。
PROJECT_ID：您的 Google Cloud專案 ID。
LOCATION：建立觸發條件的區域，例如 us-central1。

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/triggers/TRIGGER_NAME"

PowerShell (Windows)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/triggers/TRIGGER_NAME" | Select-Object -Expand Content

如果成功，回應主體會包含 Trigger 的例項，類似以下內容：

{
  "name": "projects/PROJECT_ID/locations/LOCATION/triggers/TRIGGER_NAME",
  "uid": "d700773a-698b-47b2-a712-2ee10b690062",
  "createTime": "2022-12-06T22:44:04.744001514Z",
  "updateTime": "2022-12-06T22:44:09.116459550Z",
  "eventFilters": [
    {
      "attribute": "type",
      "value": "google.cloud.pubsub.topic.v1.messagePublished"
    }
  ],
  "serviceAccount": "SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com",
  "destination": {
    "workflow": "projects/PROJECT_ID/locations/LOCATION/workflows/WORKFLOW_NAME"
  },
  "transport": {
    "pubsub": {
      "topic": "projects/PROJECT_ID/topics/TOPIC_ID",
      "subscription": "projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID"
    }
  }
}

如果觸發條件顯示 Pub/Sub 主題有問題，請參閱「觸發條件未傳送事件」一文。

更新觸發條件

您可以更新 Cloud Run、Google Kubernetes Engine (GKE) 和 Workflows 目的地的觸發事件。視目的地而定，您可以更新特定欄位。

控制台

在 Google Cloud 控制台中，前往「Eventarc」「Triggers」(觸發條件) 頁面。

前往「Triggers」(觸發條件)
在觸發條件清單中，按一下您想瞭解詳細資料的觸發條件。
在「Trigger details」(觸發條件詳細資料) 頁面中，按一下「Edit」(編輯)。
視需要編輯欄位，然後按一下「儲存」。

請注意，您無法更新任何無法使用的欄位，例如事件供應者和事件目的地。如要進一步瞭解這些欄位，請參閱管理中心的特定供應商、事件類型和目的地操作說明。

gcloud

Cloud Run

gcloud eventarc triggers update TRIGGER \
    --location=LOCATION \
    --event-filters=NEW_EVENT_FILTERS \
    --service-account=NEW_SERVICE_ACCOUNT \
    --destination-run-region=NEW_REGION \
    --destination-run-service=NEW_SERVICE \
    --destination-run-path=NEW_PATH \
    --event-data-content-type="NEW_EVENT_DATA_TYPE"

更改下列內容：

TRIGGER：觸發條件 ID 或完整修飾 ID。
LOCATION：Eventarc 觸發條件的所在位置。

您可以更新下列任何項目：

NEW_EVENT_FILTERS：用於設定觸發事件路由的篩選器，例如 methodName=storage.objects.create 可更新為 methodName=storage.objects.delete。請注意，建立觸發條件後，就無法變更 type 事件篩選器。如要使用其他事件類型，您必須建立新的觸發條件。
NEW_SERVICE_ACCOUNT：與觸發事件相關聯的 Identity and Access Management (IAM) 服務帳戶電子郵件。
NEW_REGION：可找到目標 Cloud Run 服務的區域。
NEW_SERVICE：接收觸發事件的 Cloud Run 服務名稱。
NEW_PATH：目標 Cloud Run 服務中的相對路徑，應將觸發事件傳送至此路徑。
NEW_EVENT_DATA_TYPE：事件酬載的編碼；視事件供應器而定，可能為 application/json 或 application/protobuf。

舉例來說，如要更新觸發事件的服務帳戶，請按照下列步驟操作：

gcloud eventarc triggers update my-cloud-run-trigger \
    --service-account=new-serviceaccount@${PROJECT_ID}.iam.gserviceaccount.com

這項指令會將名為 my-cloud-run-trigger 的觸發事件服務帳戶更新為 new-serviceaccount@PROJECT_ID.iam.gserviceaccount.com。

GKE

請注意，本節也適用於在 GKE 叢集中執行的私人和公開服務的公開端點。

gcloud eventarc triggers update TRIGGER \
    --location=LOCATION \
    --destination-gke-namespace=NEW_NAMESPACE \
    --destination-gke-service=NEW_SERVICE \
    --destination-gke-path=NEW_PATH \
    --event-data-content-type="NEW_EVENT_DATA_TYPE"

更改下列內容：

TRIGGER：觸發條件 ID 或完整修飾 ID。
LOCATION：Eventarc 觸發事件的位置。

您可以更新下列任何項目：

NEW_NAMESPACE：目的地 GKE 服務執行的命名空間。
NEW_SERVICE：接收觸發事件的 GKE 服務名稱。
NEW_PATH：目的地 GKE 服務中的相對路徑，該路徑是觸發事件應傳送至的目標。
NEW_EVENT_DATA_TYPE：事件酬載的編碼；視事件供應器而定，可能為 application/json 或 application/protobuf。

舉例來說，如要更新觸發事件的事件接收器服務，請按照下列步驟操作：

gcloud eventarc triggers update my-gke-trigger \
    --destination-gke-service=helloworld-events

這個指令會將名稱為 my-gke-trigger 的觸發事件更新為名稱為 helloworld-events 的 GKE 服務。

工作流程

gcloud eventarc triggers update TRIGGER \
    --location=LOCATION \
    --event-filters=NEW_EVENT_FILTERS \
    --service-account=NEW_SERVICE_ACCOUNT \
    --destination-workflow=NEW_DESTINATION_WORKFLOW \
    --destination-workflow-location=NEW_DESTINATION_WORKFLOW_LOCATION \
    --event-data-content-type="NEW_EVENT_DATA_TYPE"

更改下列內容：

TRIGGER：觸發條件 ID 或完整修飾 ID。
LOCATION：Eventarc 觸發事件的位置。

您可以更新下列任何項目：

NEW_EVENT_FILTERS：用於設定觸發事件路由的篩選器，例如 methodName=storage.objects.create 可更新為 methodName=storage.objects.delete。請注意，建立觸發條件後，就無法變更 type 事件篩選器。如要使用其他事件類型，您必須建立新的觸發條件。
NEW_SERVICE_ACCOUNT：與觸發事件相關聯的 Identity and Access Management (IAM) 服務帳戶電子郵件。
NEW_DESTINATION_WORKFLOW：接收觸發事件的已部署工作流程 ID。
NEW_DESTINATION_WORKFLOW_LOCATION：目的地工作流程的部署位置。
NEW_EVENT_DATA_TYPE：事件酬載的編碼；視事件供應器而定，可能為 application/json 或 application/protobuf。

舉例來說，如要更新觸發事件的服務帳戶，請按照下列步驟操作：

gcloud eventarc triggers update my-workflows-trigger \
    --service-account=new-serviceaccount@${PROJECT_ID}.iam.gserviceaccount.com

這項指令會將名為 my-workflows-trigger 的觸發事件服務帳戶更新為 new-serviceaccount@PROJECT_ID.iam.gserviceaccount.com。

REST

如要更新現有的觸發事件，請使用 projects.locations.triggers.patch 方法，並視需要使用 updateMask 查詢參數指定要更新的欄位清單。

使用任何要求資料之前，請先替換以下項目：

TRIGGER_NAME：要更新的觸發條件名稱。
PROJECT_ID：您的 Google Cloud專案 ID。
LOCATION：建立觸發條件的區域，例如 us-central1。
SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com：選用。與觸發事件相關聯的身分與存取權管理 (IAM) 服務帳戶電子郵件地址。
DESTINATION：選用。指定事件應傳送至的目標，並包含 Destination 的例項。例如：
{"destination": {"workflow": "projects/my-project/locations/us-central1/workflows/my-first-workflow"}}

或

{"destination": {"cloudRun": {"service": "hello-world", "region": "us-central1"}}}
EVENT_FILTER：選用。要篩選的事件屬性。只支援更新 Cloud 稽核記錄觸發事件的方法類型。例如：
{"eventFilters": [{"attribute": "methodName", "value": "storage.buckets.create"}, {"attribute": "type", "value": "google.cloud.audit.log.v1.written"}, {"attribute": "serviceName", "value": "storage.googleapis.com"}]}
請注意，您無法更新 GKE 目的地的類型。
CONTENT_TYPE：選用。事件酬載的編碼方式；視事件供應商而定，可能為 application/json 或 application/protobuf。
UPDATE_FIELDS：選用。以半形逗號分隔的要更新欄位清單。如果未提供，系統會更新要求中提供的所有欄位。例如：serviceAccount,destination

JSON 要求主體：

{
  "serviceAccount": "SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com",
  "destination": DESTINATION,
  "eventFilters" EVENT_FILTER,
  "eventDataContentType": "CONTENT_TYPE"
}

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中。在終端機中執行下列指令，即可在目前目錄中建立或覆寫此檔案：

cat > request.json << 'EOF'
{
  "serviceAccount": "SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com",
  "destination": DESTINATION,
  "eventFilters" EVENT_FILTER,
  "eventDataContentType": "CONTENT_TYPE"
}
EOF

接著，執行下列指令來傳送 REST 要求：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/triggers/TRIGGER_NAME?updateMask="UPDATE_FIELDS""

PowerShell (Windows)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

將要求主體儲存在名為 request.json 的檔案中。在終端機中執行下列指令，即可在目前目錄中建立或覆寫此檔案：

@'
{
  "serviceAccount": "SERVICE_ACCOUNT@PROJECT_ID.iam.gserviceaccount.com",
  "destination": DESTINATION,
  "eventFilters" EVENT_FILTER,
  "eventDataContentType": "CONTENT_TYPE"
}
'@  | Out-File -FilePath request.json -Encoding utf8

接著，執行下列指令來傳送 REST 要求：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/triggers/TRIGGER_NAME?updateMask="UPDATE_FIELDS"" | Select-Object -Expand Content

如果成功，回應主體會包含新建立的 Operation 例項：

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.eventarc.v1.OperationMetadata",
    "createTime": "2024-01-25T17:17:45.782370139Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/triggers/TRIGGER_NAME",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

如果 "done" 的值為 false，表示作業仍在執行中。

刪除觸發條件

您可以刪除觸發條件。

控制台

在 Google Cloud 控制台中，前往「Eventarc」「Triggers」(觸發條件) 頁面。

前往「Triggers」(觸發條件)
選取觸發條件，然後按一下「刪除」。

gcloud

gcloud eventarc triggers delete TRIGGER

將 TRIGGER 替換為觸發事件的 ID 或完整修飾的 ID。

REST

如要刪除指定名稱的觸發條件，請使用 projects.locations.triggers.delete 方法。

使用任何要求資料之前，請先替換以下項目：

PROJECT_ID：您的 Google Cloud專案 ID。
LOCATION：建立觸發條件的區域，例如 us-central1。
TRIGGER_NAME：要刪除的觸發條件名稱。

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/triggers/TRIGGER_NAME"

PowerShell (Windows)

注意：下列指令假設您已透過執行 gcloud init 或 gcloud auth login 登入 gcloud CLI。您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/triggers/TRIGGER_NAME" | Select-Object -Expand Content

如果成功，回應主體會包含 Operation 的例項：

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.eventarc.v1.OperationMetadata",
    "createTime": "2024-01-24T17:53:52.834876290Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/triggers/TRIGGER_NAME",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

如果 "done" 的值為 false，表示作業仍在執行中。

後續步驟

為特定供應商、事件類型和目的地建立觸發條件

管理觸發條件 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

列出觸發條件

控制台

gcloud

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

說明觸發條件

控制台

gcloud

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

更新觸發條件

控制台

gcloud

Cloud Run

GKE

工作流程

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

刪除觸發條件

控制台

gcloud

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

後續步驟

管理觸發條件