Azure Cosmos DB NoSQL无服务器部署失败：API版本错误求助

错误原因 #

Azure在2024-05-15-preview及后续API版本中，已废弃EnableServerless能力参数，改用CapacityMode字段来指定无服务器部署模式，这是导致你部署失败的核心原因。

具体解决方案 #

1. Azure门户创建场景

在创建Cosmos DB NoSQL账户流程中，进入容量配置步骤时，直接选择「无服务器」选项即可。门户会自动适配当前API版本的参数要求，无需手动配置旧的EnableServerless参数。

2. Azure CLI创建场景

使用CLI命令时，删除旧的--enable-serverless参数，改用--capacity-mode Serverless指定模式。示例命令：

az cosmosdb create \
  --name <你的CosmosDB账户名> \
  --resource-group <你的资源组名> \
  --location east2 \
  --capacity-mode Serverless \
  --default-consistency-level Session

3. ARM模板创建场景

在模板的资源定义中，移除capabilities数组里的EnableServerless配置，新增capacity块并指定mode为Serverless。示例片段：

{
  "type": "Microsoft.DocumentDB/databaseAccounts",
  "apiVersion": "2024-05-15-preview",
  "name": "[parameters('accountName')]",
  "location": "[parameters('location')]",
  "properties": {
    "databaseAccountOfferType": "Standard",
    "consistencyPolicy": {
      "defaultConsistencyLevel": "Session"
    },
    "locations": [
      {
        "locationName": "[parameters('location')]"
      }
    ],
    "capacity": {
      "mode": "Serverless"
    }
  }
}

你的订阅类型和资源组配置均无异常，按上述方式调整部署参数后即可完成无服务器Cosmos DB账户的创建。

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