更新GCS桶的EventArc触发器时gcloud命令报错排查

问题详情 #

执行触发器更新操作时收到如下错误：

ERROR: (gcloud.eventarc.triggers.update) INVALID_ARGUMENT: The request was invalid: missing required attribute 'type' in trigger.event_filters
- '@type': type.googleapis.com/google.rpc.BadRequest fieldViolations: field: trigger.event_filters
- '@type': type.googleapis.com/google.rpc.RequestInfo requestId: 120f43d9f5c9aba4

使用的脚本逻辑为检查触发器存在性，存在则更新，不存在则创建：

# Check if the Eventarc trigger exists
EXISTING_TRIGGER=$(gcloud eventarc triggers list --location=$REGION --filter="name:$TRIGGER_NAME" --format="value(name)")

if [ -n "$EXISTING_TRIGGER" ]; then
  echo "Trigger exists. Updating the trigger..."
  # Update the existing trigger
  gcloud eventarc triggers update $TRIGGER_NAME \
    --location=$REGION \
    --service-account=$SERVICE_ACCOUNT \
    --destination-run-service=$SERVICE_NAME \
    --destination-run-region=$REGION \
    --event-filters="type=google.cloud.storage.object.v1.finalized" \
    --event-filters="bucket=$BUCKET_NAME"
else
  echo "Trigger does not exist. Creating a new trigger..."
  # Create a new trigger
  gcloud eventarc triggers create $TRIGGER_NAME \
    --location=$REGION \
    --service-account=$SERVICE_ACCOUNT \
    --destination-run-service=$SERVICE_NAME \
    --destination-run-region=$REGION \
    --event-filters="type=google.cloud.storage.object.v1.finalized" \
    --event-filters="bucket=$BUCKET_NAME"
fi

创建逻辑正常，但更新时触发错误，已确认官方文档标注event-filters为可更新字段，希望明确问题根源，避免仅依赖删除重建的方案。

问题根源与解决 #

核心原因 #

EventArc CLI在创建和更新触发器时，对--event-filters参数的格式要求不一致：

• 创建触发器时，允许多次使用--event-filters参数（每个参数传递一个键值对），CLI会自动合并为完整的事件过滤器集合。
• 更新触发器时，CLI要求所有事件过滤器必须通过单个--event-filters参数传递，多个键值对用逗号分隔。

当前更新命令将type和bucket拆分为两个独立的--event-filters参数，CLI会将它们识别为两组独立的过滤器规则，每组都缺少必填的type字段，因此触发参数无效错误。

修正后的更新命令 #

将两个--event-filters合并为单个参数：

gcloud eventarc triggers update $TRIGGER_NAME \
  --location=$REGION \
  --service-account=$SERVICE_ACCOUNT \
  --destination-run-service=$SERVICE_NAME \
  --destination-run-region=$REGION \
  --event-filters="type=google.cloud.storage.object.v1.finalized,bucket=$BUCKET_NAME"

额外注意事项 #

• 更新触发器时，event-filters是全量覆盖而非增量更新，即使只需要修改其中一个过滤条件（比如仅修改bucket），也必须传递完整的过滤器集合（包括type）。
• 可通过以下命令查看当前触发器的完整配置，确保更新参数准确：

  gcloud eventarc triggers describe $TRIGGER_NAME --location=$REGION
  

内容的提问来源于stack exchange，提问作者VKarthik