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

管理觸發條件

標準

您可以使用 Google Cloud 控制台或 Google Cloud CLI 管理觸發條件，無論是在終端機或 Cloud Shell 中皆可。您也可以透過 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 init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或使用 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」(觸發條件)
在觸發條件清單中，按一下要查看詳細資料的觸發條件。
在「觸發條件詳細資料」頁面中，按一下「編輯」。
視需要編輯欄位，然後按一下「儲存」。

請注意，您無法更新任何無法使用的欄位，例如「活動供應商」和「活動目的地」。如要進一步瞭解這些欄位，請參閱控制台的特定供應商、事件類型和目的地操作說明。

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事件篩選器就無法變更。如要使用其他事件類型，請建立新的觸發條件。
：與觸發程序相關聯的身分與存取權管理 (IAM) 服務帳戶電子郵件地址。NEW_SERVICE_ACCOUNT
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 事件篩選器就無法變更。如要使用其他事件類型，請務必建立新的觸發條件。
：與觸發程序相關聯的身分與存取權管理 (IAM) 服務帳戶電子郵件地址。NEW_SERVICE_ACCOUNT
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 或完整識別碼。

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)

後續步驟

管理觸發條件