创建Azure Redis Enterprise资源时持续遭遇终端预配失败错误

错误信息 #

{"code":"ResourceDeploymentFailure","target":"/subscriptions/xxxxx-484f-4daf-a0bd-xxxxxxxx/resourceGroups/rg-prod/providers/Microsoft.Cache/redisEnterprise/redis-cache","message":"The resource write operation failed to complete successfully, because it reached terminal provisioning state 'Failed'."}

排查步骤 #

• 配额与权限检查

  1. 确认订阅拥有Microsoft.Cache/redisEnterprise/write权限，可通过IAM角色验证（比如Contributor或Redis Enterprise Contributor角色）。
  2. 检查目标区域的Redis Enterprise配额：进入Azure门户→订阅→配额→搜索Microsoft.Cache/redisEnterprise，确认CPU、内存等资源未超出上限。

• 配置参数验证

  1. 区域与SKU兼容性：确认所选区域支持你指定的Redis Enterprise SKU（如Enterprise E10、Flash F30等），部分SKU仅在特定区域可用。
  2. 虚拟网络配置（若使用VNet注入）：
     • 子网大小需至少为/24（256个IP地址），且未关联其他冲突资源。
     • 子网的网络安全组（NSG）需允许Redis Enterprise所需端口：6380（非SSL）、6381（SSL）、10000-10006（集群通信）。
  3. 实例配置：确认副本数、分片数等参数未超出区域支持的上限，比如部分区域副本数最多为3。

• 获取详细错误日志

  1. 门户查看：进入资源组→部署历史记录→找到失败的部署→点击“查看详细信息”，获取具体错误代码（如QuotaExceeded、InvalidSubnet），这是定位问题的核心依据。
  2. CLI命令查询：

     # 查看部署详细错误信息
     az deployment group show -g rg-prod -n <部署名称> --query properties.error
     # 查看资源操作日志
     az monitor activity-log list --resource-group rg-prod --resource "/subscriptions/xxxxx-484f-4daf-a0bd-xxxxxxxx/resourceGroups/rg-prod/providers/Microsoft.Cache/redisEnterprise/redis-cache" --query "[].properties.statusMessage"
     

• 命名与资源冲突检查
  确认Redis Enterprise实例名称符合Azure规则：仅含小写字母、数字、连字符，长度2-63字符，且同一区域同一资源组内无同名资源。

• 服务状态验证
  进入Azure门户→服务健康→检查目标区域的Redis Enterprise服务是否存在临时故障或维护事件。

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