Azure Search免费层创建数据源返回403 Forbidden问题咨询

遇到这种无额外提示的403确实挺让人困惑的，结合Azure Cognitive Search免费层的限制和你的请求细节，我整理了几个最可能的原因和对应的解决步骤：

1. 触发免费层资源配额上限 #

Azure Search免费层有严格的资源数量限制：

• 最多3个索引
• 最多3个索引器
• 最多3个数据源
• 总存储容量不超过50MB

你以为是新增第二个数据源，但可能之前的测试操作已经创建了3个数据源（比如重复创建未删除），直接触发了配额限制导致403。

排查&解决：
登录Azure门户，找到你的Search服务，依次进入「数据资源」→「数据源」，查看现有数据源的数量。如果已经达到3个，删除不用的旧资源后再尝试新建。

2. 使用了权限不足的API密钥 #

Azure Search的密钥分为两种：

• 查询密钥：仅拥有只读权限，只能用于搜索/查询操作，无法创建、修改或删除数据源、索引等资源
• 管理员密钥：分为主密钥和副密钥，拥有完整的读写权限，是创建资源必须使用的密钥

你当前使用的api-key大概率是查询密钥，而非管理员密钥，导致权限不足返回403。

排查&解决：
在Azure门户的Search服务页面，进入「密钥」选项卡，复制主密钥或副密钥替换请求头中的api-key，重新发送请求。

3. 使用了过旧的API版本 #

你请求中使用的api-version=2016-09-01是非常老旧的版本，虽然微软会保持旧版本的兼容性，但部分免费层的新配额限制逻辑在旧版本中可能不会返回明确的错误提示，直接返回403。

排查&解决：
将请求URL中的API版本替换为较新的稳定版本，比如2023-11-01，修改后的URL为：

https://my-search-service-name.search.windows.net/datasources?api-version=2023-11-01

4. 请求体格式或配置存在问题 #

虽然你提到请求体是{"name": "datasource-prod", "descr..."}，但可能存在格式错误（比如引号未闭合、字段拼写错误），或者数据源的配置不符合要求（比如存储账户连接字符串无效）。部分情况下，这类问题也会被免费层的权限校验逻辑拦截返回403（而非更准确的400错误）。

排查&解决：
先简化请求体为一个最基础的有效配置进行测试，比如Azure Blob存储的数据源配置：

{
  "name": "datasource-prod",
  "type": "azureblob",
  "credentials": { "connectionString": "DefaultEndpointsProtocol=https;AccountName=你的存储账户名;AccountKey=你的存储账户密钥;EndpointSuffix=core.windows.net" },
  "container": { "name": "你的容器名" }
}

确保JSON格式完全正确，配置信息有效后再发送请求。

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