ARM模板配置VNET服务端点至Azure SQL遇错咨询

我来帮你拆解这两个在部署VNET服务端点和Azure SQL规则时遇到的常见问题：

疑问1：为什么错误提示Microsoft.Sql无效，却又将其列入支持服务名称？ #

这种矛盾的错误信息其实大多是拼写或格式的细微问题导致的，而非服务名称本身无效：

• ARM模板对服务端点策略里的服务名称要求很严格，哪怕是大小写错误（比如写成microsoft.sql）、多了空格，或者JSON格式错误（比如数组里的字符串漏加引号），都会被判定为无效
• Azure的错误提示逻辑有点“耿直”：它会把所有支持的服务名称都列出来，哪怕你写的是正确名称，但只要模板里存在语法/格式问题，就会触发“无效服务名称”的错误，同时把正确选项抛出来给你参考
• 你可以检查一下服务端点策略定义的写法，确保是标准格式：

  "serviceEndpointPolicyDefinitions": [
    {
      "name": "AllowVNETtoSQLPolicy",
      "properties": {
        "description": "Allow subnet access to SQL",
        "service": "Microsoft.Sql",
        "serviceResources": [
          "[resourceId('Microsoft.Sql/servers', parameters('sqlServerName'))]"
        ]
      }
    }
  ]
  

  重点确认service字段的拼写、大小写，以及整个JSON结构没有语法错误。

疑问2：服务端点部署的依赖项配置遗漏了什么？ #

你设置的ignoreMissingVnetServiceEndpoint": true确实能跳过“子网未启用服务端点”的检查，但它解决不了子网处于Updating状态的问题——这是因为ARM模板默认会并行部署资源，导致SQL的VNET规则在子网更新服务端点的过程中就开始创建，Azure会因为子网状态不稳定而报错。

你需要添加明确的依赖关系来强制部署顺序：

1. 在SQL的virtualNetworkRules资源中，把子网的资源ID加入dependsOn数组，确保SQL规则等子网的服务端点配置完成后再部署：

   "resources": [
     {
       "type": "Microsoft.Sql/servers/virtualNetworkRules",
       "name": "[concat(parameters('sqlServerName'), '/', parameters('vnetRuleName'))]",
       "apiVersion": "2021-11-01",
       "dependsOn": [
         // 依赖子网的部署完成
         "[resourceId('Microsoft.Network/virtualNetworks/subnets', parameters('virtualNetworkName'), parameters('subnetName'))]",
         // 如果用了服务端点策略，也要依赖策略
         "[resourceId('Microsoft.Network/serviceEndpointPolicies', parameters('serviceEndpointPolicyName'))]"
       ],
       "properties": {
         "virtualNetworkSubnetId": "[resourceId('Microsoft.Network/virtualNetworks/subnets', parameters('virtualNetworkName'), parameters('subnetName'))]",
         "ignoreMissingVnetServiceEndpoint": true
       }
     }
   ]
   

2. 另外，启用VNET服务端点本身需要几分钟时间，明确的依赖关系会让ARM模板等待子网状态稳定后再继续部署SQL规则，避免状态冲突。

如果还是遇到问题，可以尝试分两步部署：先更新VNET（包含服务端点和策略），等部署完成后再部署SQL的VNET规则，但通过dependsOn配置自动控制顺序是更优雅的方案。

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