Eventarc 触发器声明您对某个事件或一系列事件感兴趣。如需配置事件路由，您可以为触发器指定过滤条件，包括事件来源和目标工作流。
事件通过 HTTP 请求以 CloudEvents 格式传送。Workflows 服务将事件转换为 JSON 对象（遵循 CloudEvents 规范），并将事件作为工作流运行时参数传递给工作流执行。确保事件大小不超过 512 KB。大于 Workflows 参数大小上限的事件不会触发工作流执行。
以下说明介绍如何配置事件路由，以便触发工作流执行来响应直接 Transcoder API 事件。如需了解详情，请参阅支持的直接事件列表。准备创建触发器
在为目标工作流创建 Eventarc 触发器之前，请完成以下任务。
控制台
在 Google Cloud 控制台的“项目选择器”页面上，选择或创建 Google Cloud 项目。
启用 Eventarc、Eventarc Publishing、Workflows 和 Workflow Executions API。
如果适用，请启用与直接事件相关的 API。例如，对于 Transcoder API 事件，请启用 Transcoder API API。
如果您还没有用户管理的服务账号，请创建一个，并为其授予必要的角色和权限，以便 Eventarc 可以管理目标工作流的事件。
在 Google Cloud 控制台中，转到服务账号页面。
选择您的项目。
在服务账号名称字段中，输入一个名称。Google Cloud 控制台会根据此名称填充服务账号 ID 字段。
在服务账号说明字段中，输入说明。例如
Service account for event trigger。点击创建并继续。
如需提供适当的访问权限，请在选择角色列表中，选择要向服务账号授予的所需 Identity and Access Management (IAM) 角色。如需了解详情，请参阅 Workflows 目标的角色和权限。
如需添加其他角色，请点击 添加其他角色，然后添加其他各个角色。
点击继续。
如需完成账号的创建过程，请点击完成。
gcloud
在 Google Cloud 控制台中，激活 Cloud Shell。
Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动，并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。
启用 Eventarc、Eventarc Publishing、Workflows 和 Workflow Executions API：
gcloud services enable eventarc.googleapis.com \ eventarcpublishing.googleapis.com \ workflows.googleapis.com \ workflowexecutions.googleapis.com如果适用，请启用与直接事件相关的 API。例如，对于 Transcoder API 事件，请启用
transcoder.googleapis.com。如果您还没有用户管理的服务账号，请创建一个，并为其授予必要的角色和权限，以便 Eventarc 可以管理目标工作流的事件。
创建服务账号：
gcloud iam service-accounts create SERVICE_ACCOUNT_NAME
将
SERVICE_ACCOUNT_NAME替换为服务账号的名称。该名称必须介于 6 到 30 个字符之间，且可以包含小写字母数字字符和短划线。在服务账号创建完毕后，无法再更改其名称。授予所需的 Identity and Access Management (IAM) 角色或权限。如需了解详情，请参阅 Workflows 目标的角色和权限。
创建触发器
您可以使用 Google Cloud CLI（gcloud 或 Terraform）或通过 Google Cloud 控制台创建将已部署工作流作为事件接收器的 Eventarc 触发器。
控制台
- 在 Google Cloud 控制台中，进入 Eventarc 触发器页面。
- 点击 创建触发器。
- 输入触发器名称。
这是触发器的 ID，必须以字母开头。最多可包含 63 个小写字母、数字或连字符。
- 在触发器类型部分，选择 Google 来源。
- 在事件提供方列表中，选择 Transcoder API。
请注意，关联的 Google Cloud 文档中使用的事件提供方名称可能没有 Cloud 或 Google Cloud 前缀。例如，在控制台中，Memorystore for Redis 称为 Google Cloud Memorystore for Redis。
- 在事件类型列表中，从“直接”事件中选择事件类型。
- 如需指定事件载荷的编码，请在事件数据内容类型列表中选择 application/json 或 application/protobuf。
请注意，采用 JSON 格式的事件载荷大于采用 Protobuf 格式的事件载荷。这可能会影响可靠性，具体取决于您的事件目标及其事件大小限制。如需了解详情，请参阅已知问题。
- 在区域列表中，选择生成事件的 Google Cloud 服务所在的区域。
如需了解详情，请参阅 Eventarc 位置。
- 如果适用于事件提供方，请点击添加过滤条件并指定以下内容：
- 选择将调用您的服务或工作流的服务账号。
或者，您可以创建新的服务账号。
这用于指定与触发器相关联且您之前向其授予 Eventarc 所需的特定角色的 Identity and Access Management (IAM) 服务账号电子邮件。
- 在事件目的地列表中，选择 Workflows。
- 选择工作流。
这是要将事件传递给的工作流的名称。工作流执行的事件会被转换并作为运行时参数传递给工作流。
如需了解详情，请参阅为工作流创建触发器。
- 点击创建。
创建触发器之后，您便无法修改事件来源过滤条件。请创建新触发器，并删除旧触发器。 如需了解详情，请参阅管理触发器。
gcloud
您可以通过运行包含必需和可选标志的 gcloud eventarc triggers create 命令来创建触发器。
gcloud eventarc triggers create TRIGGER \
--location=LOCATION \
--destination-workflow=DESTINATION_WORKFLOW \
--destination-workflow-location=DESTINATION_WORKFLOW_LOCATION \
--event-filters="type=EVENT_FILTER_TYPE" \
--event-filters="COLLECTION_ID=RESOURCE_ID" \
--event-filters-path-pattern="COLLECTION_ID=PATH_PATTERN" \
--event-data-content-type="EVENT_DATA_CONTENT_TYPE" \
--service-account="SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"
替换以下内容：
TRIGGER：触发器的 ID 或完全限定标识符。LOCATION：Eventarc 触发器的位置。或者，您可以设置eventarc/location属性；例如gcloud config set eventarc/location us-central1。为避免任何性能和数据驻留问题，该位置必须与生成事件的 Google Cloud 服务的位置匹配。如需了解详情，请参阅 Eventarc 位置。
-
DESTINATION_WORKFLOW：从触发器接收事件的已部署工作流的 ID。 工作流可以位于 Workflows 支持的任何位置，无需与触发器位于同一位置。但是，工作流必须与触发器位于同一项目中。 -
DESTINATION_WORKFLOW_LOCATION（可选）：目标工作流的部署位置。如果未指定，系统将假定工作流与触发器位于同一位置。 EVENT_FILTER_TYPE：事件的标识符。方法的 API 调用成功时会生成事件。对于长时间运行的操作，事件仅会在操作结束时生成，并且仅在操作成功执行时才会生成。如需查看支持的事件类型的列表，请参阅 Eventarc 支持的事件类型。
COLLECTION_ID（可选）：可充当事件过滤条件的资源组件，它是以下组件之一：jobjobTemplate
-
RESOURCE_ID：用作关联集合的过滤值的资源的标识符。如需了解详情，请参阅资源 ID。 -
PATH_PATTERN：过滤资源时要应用的路径模式 -
EVENT_DATA_CONTENT_TYPE：（可选）事件载荷的编码。可以为application/json或application/protobuf。默认编码为application/json。请注意，采用 JSON 格式的事件载荷大于采用 Protobuf 格式的事件载荷。这可能会影响可靠性，具体取决于您的事件目标及其事件大小限制。如需了解详情，请参阅已知问题。
-
SERVICE_ACCOUNT_NAME：您创建的 IAM 服务账号的名称，您已向其授予 Workflows 所需的特定角色。 -
PROJECT_ID：您的 Google Cloud 项目 ID
备注：
--event-filters="type=EVENT_FILTER_TYPE"标志是必需的。如果未设置其他事件过滤条件，则匹配所有资源的事件。EVENT_FILTER_TYPE创建后无法更改。如需更改EVENT_FILTER_TYPE，请创建一个新触发器并删除旧触发器。- 每个触发器可以有多个事件过滤条件，在一个
--event-filters=[ATTRIBUTE=VALUE,...] 标志内以英文逗号分隔，您也可以重复使用该标志来添加更多过滤条件。只有符合所有过滤条件的事件会被发送到目的地。不支持通配符和正则表达式；但是，使用--event-filters-path-pattern标志时，您可以定义资源路径模式。 --service-account标志用于指定与触发器关联的 Identity and Access Management (IAM) 服务账号电子邮件。
示例：
gcloud eventarc triggers create helloworld-trigger \
--location=us-central1 \
--destination-workflow=my-workflow \
--destination-workflow-location=us-central1 \
--event-filters="type=google.cloud.video.transcoder.job.v1.created" \
--event-filters-path-pattern="job=my-job-*" \
--service-account="${SERVICE_ACCOUNT_NAME}@${PROJECT_ID}.iam.gserviceaccount.com"
此命令会为标识为 google.cloud.video.transcoder.job.v1.created 的事件创建一个名为 helloworld-trigger 的触发器，并针对以 my-job- 开头的 job ID 匹配事件。
Terraform
您可以使用 Terraform 为工作流创建触发器。如需了解详情，请参阅使用 Eventarc 和 Terraform 触发工作流。
列出触发器
如需确认触发器已创建，您可以使用 Google Cloud CLI 或通过 Google Cloud 控制台列出 Eventarc 触发器。
控制台
在 Google Cloud 控制台中，进入 Eventarc 触发器页面。
此页面会列出所有位置的触发器，并包含名称、区域、事件提供方、目标位置等详细信息。
如需过滤触发器，请执行以下操作：
- 点击 过滤或过滤触发器字段。
- 在属性列表中，选择要作为触发器过滤条件的选项。
您可以选择单个属性，或使用逻辑运算符
OR添加更多属性。如需对触发器进行排序，请点击任意受支持的列标题旁边的 排序。
gcloud
运行以下命令可列出触发器：
gcloud eventarc triggers list --location=-
此命令会列出所有位置的触发器，并包含名称、类型、目标位置和状态等详细信息。