Azure CLI 2.70.0 版本在生成存储容器SAS令牌时的兼容性问题解析

问题背景

在Azure CLI 2.70.0版本中，用户在使用az storage container generate-sas命令为美国政府区域(usgovvirginia)的存储账户生成SAS令牌时遇到了兼容性问题。该问题表现为命令执行失败，并返回API版本不匹配的错误信息。

错误现象

当用户尝试执行以下命令时：

az storage container generate-sas --account-name mystorageaccount --account-key $key -n default --https-only --permissions rl --expiry $end -o tsv

系统返回错误提示：

No registered resource provider found for location 'usgovvirginia' and API version '2024-01-01' for type 'storageAccounts'

错误信息明确指出，在usgovvirginia区域，存储账户服务不支持2024-01-01版本的API，并列举了该区域支持的API版本列表。

技术分析

这个问题源于Azure CLI 2.70.0版本默认使用了较新的API版本(2024-01-01)，而美国政府区域的存储服务尚未支持这一最新API版本。这种区域间的API版本支持差异在云服务中并不罕见，特别是在政府云等特殊环境中，服务更新往往会有所延迟。

错误信息中列出的支持版本包括从2015-05-01-preview到2023-05-01的多个版本，这表明美国政府区域的存储服务API版本支持确实落后于全球版Azure。

解决方案

Azure CLI团队确认这是一个服务端问题，并已进行了修复部署。用户反馈在修复部署完成后，问题已得到解决。

对于遇到类似问题的用户，可以考虑以下建议：

1. 检查并确认所使用的Azure CLI版本
2. 了解目标区域支持的API版本范围
3. 在必要时，可以通过指定API版本参数来强制使用特定版本
4. 关注Azure更新日志，了解各区域服务更新的时间表

经验总结

这个案例提醒我们，在使用云服务时需要考虑不同区域可能存在的服务差异，特别是在使用政府云、主权云等特殊环境时。作为最佳实践：

• 在自动化脚本中增加版本兼容性检查
• 对关键操作实现错误处理和重试机制
• 保持对服务更新和变更的关注
• 在跨区域部署时进行充分的兼容性测试

通过这个问题的解决过程，我们可以看到Azure团队对用户反馈的快速响应能力，以及云服务持续更新迭代的特点。