如何使用Fiddler/Postman调用Azure Table Storage REST API并获取响应

我明白你之前用Fiddler操作Blob Storage很顺手，但Table Storage的REST API确实有几个关键的不同点，尤其是在认证和请求格式上。别担心，我一步步带你搞定，让你能轻松用Fiddler（或者Postman）调用它，还能拿到JSON/XML格式的响应：

1. 核心差异：认证方式的注意事项 #

和Blob Storage一样，Table Storage支持Shared Key认证和SAS（共享访问签名）认证，但Table的Shared Key签名规则和Blob略有不同，这也是很多人踩坑的地方。如果嫌麻烦，直接用SAS会更简单。

用SAS认证（推荐新手） #

你可以在Azure Portal里直接生成Table的SAS URL：

• 进入你的存储账户 → 左侧“共享访问签名” → 勾选“表”权限，设置有效期和允许的操作（比如读、写）
• 生成后，SAS URL会包含所有必要的认证参数，直接在Fiddler里用这个URL发起请求就行，不需要额外加Authorization头。

用Shared Key认证（适合需要自定义请求的场景） #

如果要用Shared Key，你需要手动构造Authorization头，签名字符串的格式是：

<HTTP方法>\n
<Content-MD5>\n
<Content-Type>\n
<Date>\n
<CanonicalizedHeaders>\n
<CanonicalizedResource>

举个GET请求的例子，签名字符串大概是这样：

GET\n\n\n\n\n\nx-ms-date:Fri, 15 Sep 2023 12:00:00 GMT\nx-ms-version:2020-08-04\n/mystorageaccount/mytable

然后用你的存储账户密钥对这个字符串进行HMAC-SHA256加密，再Base64编码，最后构造Authorization头：

Authorization: SharedKey mystorageaccount:<Base64编码的签名>

2. Fiddler中构建请求的具体步骤 #

以获取表中所有实体为例，一步步来：

步骤1：设置请求方法和URL #

• 请求方法：GET
• URL格式：https://<你的存储账户名>.table.core.windows.net/<表名>?$format=json（加$format=json直接返回JSON，不加默认返回XML/Atom格式）

步骤2：添加必要的请求头 #

在Fiddler的“Headers”标签里添加以下头部：

• x-ms-date: 当前UTC时间，格式比如Fri, 15 Sep 2023 12:00:00 GMT（必须是UTC，不能用本地时间）
• x-ms-version: 指定API版本，推荐用2020-08-04或更高版本（旧版本可能不支持JSON格式）
• 如果用Shared Key认证，还要加上Authorization头（按上面的规则构造）

步骤3：发送请求并查看响应 #

点击Fiddler的“Execute”按钮，然后在“Response”标签里就能看到JSON或XML格式的响应了。

3. 其他常见请求示例 #

创建新表（POST请求） #

• 请求方法：POST
• URL：https://<你的存储账户名>.table.core.windows.net/Tables
• 请求头：
  • x-ms-date: <UTC时间>
  • x-ms-version: 2020-08-04
  • Content-Type: application/atom+xml
  • Authorization: SharedKey <你的签名>
• 请求体（XML格式）：

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">
  <title />
  <updated>2023-09-15T12:00:00Z</updated>
  <author>
    <name />
  </author>
  <id />
  <content type="application/xml">
    <m:properties>
      <d:TableName>MyNewTable</d:TableName>
    </m:properties>
  </content>
</entry>

插入新实体（POST请求） #

如果要插入JSON格式的实体，URL加$format=json，请求头加Content-Type: application/json，请求体示例：

{
  "PartitionKey": "Customer1",
  "RowKey": "Order001",
  "OrderDate": "2023-09-15T12:00:00Z",
  "TotalAmount": 99.99
}

4. 常见问题排查 #

如果你之前能操作Blob但Table不行，大概率是这几个原因：

• 认证头构造错误：Table的签名字符串必须包含x-ms-date和x-ms-version，而Blob的签名规则略有不同，别直接照搬Blob的签名方式
• 没有指定API版本：旧版本的Table API不支持JSON响应，一定要加x-ms-version头
• URL格式错误：Table的URL是https://<账户>.table.core.windows.net/<表名>，和Blob的https://<账户>.blob.core.windows.net/<容器>/<文件>格式不一样，别搞混了
• 权限问题：确保你的存储账户密钥或SAS有对应的Table操作权限（比如读、写）

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