Azure Pipeline中部署Blob存储Webhook的ARM模板持续失败

问题现象 #

在Azure Pipeline中运行ARM模板创建Blob存储的Webhook时失败，收到错误：

##[error]InvalidRequest: There is an existing tracked system topic for the given source /subscriptions/xxxxx-fa00-4048-9d12-4b3ce3d40d34/resourceGroups/dev-companyName/providers/Microsoft.Storage/storageAccounts/storageAccountName. Only one system topic is allowed per source.

目标存储账户下已存在自动生成的系统主题：storageAccountName-xxxxx-802d-4436-bb67-f8d4a60fb5bd，疑惑是否因Webhook已存在导致模板创建失败，且模板是参照官方文档编写。

错误原因 #

这个错误不是因为Webhook（事件订阅）已存在，而是Azure Event Grid的核心限制：每个存储账户（Event Grid源）只能绑定一个系统主题（System Topic）。当前存储账户已经通过手动创建、非模板部署等方式生成了自动命名的系统主题，而你的ARM模板尝试创建一个以存储账户名称命名的新系统主题，触发了唯一性限制。

ARM模板默认是增量部署模式（仅创建/更新资源，不会删除），但系统主题的唯一性规则导致无法重复创建。

模板问题与修复方案 #

模板核心问题 #

模板中硬指定系统主题名称为存储账户名，但现有系统主题是带随机后缀的自动生成名称，导致名称不匹配，模板尝试创建新资源时触发冲突。

具体修复方案 #

方案1：复用现有系统主题（推荐）

无需重新创建系统主题，修改模板关联已存在的资源：

1. 确认现有系统主题名称（即storageAccountName-xxxxx-802d-4436-bb67-f8d4a60fb5bd），也可通过Azure CLI命令获取：

   az eventgrid system-topic list --resource-group dev-companyName
   

2. 调整模板：移除Microsoft.EventGrid/systemTopics资源块（避免尝试创建新主题），同时修改事件订阅的名称和依赖项，指向现有系统主题：

   {
     "apiVersion": "2021-12-01",
     "type": "Microsoft.EventGrid/systemTopics/eventSubscriptions",
     "name": "[format('{0}/{1}', 'storageAccountName-xxxxx-802d-4436-bb67-f8d4a60fb5bd', variables('subscriptions').eventSubscriptions.dataStorageBlobCreatedHookZipfile)]",
     "properties": {
       "destination": {
         "endpointType": "WebHook",
         "properties": {
           "endpointUrl": "[variables('functionUrls').zipFileProcessorUrl]"
         }
       },
       "filter": {
         "subjectBeginsWith": "",
         "subjectEndsWith": "",
         "isSubjectCaseSensitive": false,
         "includedEventTypes": [
           "Microsoft.Storage.BlobCreated"
         ]
       }      
     },
     "dependsOn": [
       "[resourceId('Microsoft.Storage/storageAccounts',variables('storageAccountName').name)]"
     ]
   }
   

方案2：统一通过模板管理系统主题

如果需要完全用模板管控系统主题：

1. 删除现有自动生成的系统主题（注意：删除会同步删除关联的事件订阅，需重新配置）；
2. 重新运行原模板，此时会创建以存储账户名命名的系统主题，后续增量部署时因名称匹配，只会更新资源而非重复创建。

补充说明 #

ARM模板增量部署模式下，会通过资源类型、资源名称、资源组三者匹配现有资源：匹配到则更新，匹配不到则创建。因此确保模板中资源名称与现有资源一致，就能避免冲突。

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