Azure Cosmos DB账户网络设置添加IP时独占锁错误原因排查

问题描述 #

操作步骤 #

• 进入Azure Portal
• 获取目标Azure Cosmos DB Account资源
• 打开该资源并进入Networking标签页
• 在右侧面板切换至Public access标签页
• 切换为selected networks选项
• 在下方出现的IP输入文本框中填入目标IP地址
• 点击Save按钮

预期结果 #

新IP地址成功保存并加入允许访问的IP列表

实际异常 #

Azure Portal右上角提示错误：

"There is already an operation in progress that requires exclusive lock"

咨询内容 #

1. 该错误中的「独占锁」具体指什么？
2. 在Cosmos DB账户网络设置场景下，哪些操作会导致添加新IP时触发这个锁定？

解答 #

1. 错误中的独占锁是什么 #

这个独占锁是Azure给Cosmos DB资源加的排他性操作限制——说白了就是防止同时有多个修改操作改动同一个账户的核心配置，避免出现配置冲突或数据不一致的情况。当某个需要修改账户状态的操作正在执行时，Azure会自动给资源上锁，阻止其他同类修改操作同时进行，直到当前操作完成或超时释放锁。

2. 会导致添加IP时被锁定的操作 #

在Cosmos DB账户网络设置的场景下，以下操作会占用独占锁，导致添加IP的保存操作失败：

• 其他会话/终端正在修改该Cosmos DB账户的网络配置（比如同事在另一窗口修改IP白名单、切换公共访问模式）
• 账户正在执行核心配置变更操作，例如：
  • 修改账户的一致性级别
  • 启用或禁用多区域写入功能
  • 调整自动缩放的参数设置
  • 更改加密配置（如切换为客户管理密钥）
  • 正在进行账户的故障转移操作
• 通过Azure CLI、PowerShell或自动化工具批量修改该账户配置，且操作尚未完成
• Azure平台正在对该账户执行后台维护操作（比如版本升级、故障修复等）

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