Azure Bicep/ARM 建议使用的 API 版本(预览版与稳定版)

Question

我正在研究 Azure Bicep/ARM 模板，我想知道在多个团队将使用的大型组织中创建模板时，在资源提供程序上使用 API 版本的安全/推荐方法。

如果我们声明资源类型并使用 API 版本，我们在预览版本和稳定版本方面会有很多选择。我们一直知道，建议使用稳定版本，但大多数情况下它看起来太旧，而预览看起来是最新的。

在下面的 SQL Server 资源屏幕截图中，预览版看起来是最新且稳定的 2014 年版本，这可能会导致最新功能受到影响

那么，我们如何决定稳定/安全但涵盖最新功能而不破坏更改的 API 版本

resource sqlServer 'Microsoft.Sql/servers@2021-11-01-preview' = {
  name: serverName
  location: location
  tags: tags
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    version: version
    publicNetworkAccess: 'Enabled'
    administratorLogin: adminUserName
    administratorLoginPassword: administratorLoginPassword
  }
}

Answer 1

您可以使用的一些指导...

• 使用最新的非预览版 apiVersion，除非您需要的功能仅在较新/预览版本中可用(对于 SQL 来说也是如此)
• 除非新版本中有您需要的功能，否则您无需升级 apiVersion。每年左右重新访问一次以查看是否有可用的新功能(再次是 SQL 示例)并没有什么坏处 - 但除了新功能之外，您没有理由总是需要使用“最新”
• 新的 apiVersions 更多的是关于功能和架构更改，而不是“稳定性” - 正如 Matt Douhan 提到的，如果有一个公开可用的 apiVersion(即公共(public)预览版)，则其受支持并被视为“稳定”。

HTH