如何通过Postman调用API在Azure Cosmos DB Table API中创建实体

正确的实体创建端点 #

Cosmos DB表API创建实体的标准端点格式为：
https://<你的CosmosDB账户名>.table.cosmos.azure.com/Tables/<表名>/Entities

注意：如果是Core(SQL) API下的容器操作，端点逻辑不同，但针对表API的实体创建，必须遵循上述路径结构。

请求核心配置 #

• 请求方法：必须使用POST
• 必填请求头：
  • Content-Type: application/json
  • x-ms-version: 2019-02-02（或更高兼容版本）
  • x-ms-date: 当前UTC时间（格式示例：Fri, 15 Sep 2023 12:00:00 GMT）
  • Authorization: 基于Cosmos DB账户密钥生成的HMAC签名（Postman可借助Cosmos DB授权工具自动生成，APIM中可通过策略表达式或命名凭证处理）
• 请求体要求：实体必须包含PartitionKey和RowKey两个必填字段，示例JSON：

{
  "PartitionKey": "user-group-01",
  "RowKey": "user-1001",
  "UserName": "John Doe",
  "Age": 30
}

错误原因分析 #

你之前遇到的{"code":"MethodNotAllowed","message":"RequestHandler.Post"}错误，主要原因是：

• 端点路径错误：你使用的https://mycosmosdburldbs/TablesDB/colls/mytable/不符合表API的实体创建路径规范
• 请求头缺失或格式错误：比如未指定正确的x-ms-version，或者签名无效导致服务拒绝请求

Azure API Management策略实现注意事项 #

在APIM策略中部署时，需要：

1. 替换端点占位符为实际的Cosmos DB账户名和目标表名
2. 通过策略添加所有必填请求头，其中Authorization签名可使用APIM内置的HMAC生成逻辑，结合存储在命名凭证中的账户密钥完成
3. 确保转发的请求体包含PartitionKey和RowKey字段，符合表API的实体结构要求

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