You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

通过账户名密钥调用REST API获取Azure文件存储文件报404

Azure File Storage REST API返回404问题修复

你当前的Postman配置存在3个核心错误,逐一修正后即可正常获取文件:

  • 缺失必填授权头:Azure存储REST接口所有请求必须携带基于账户密钥生成的HMAC-SHA256签名,你当前仅配置了x-ms-version请求头,无合法签名的请求会被服务端拦截,部分场景下会直接返回404状态码而非401,避免泄露资源存在性信息。
  • API版本配置过旧:2014-02-14版本的文件服务接口存在路径校验兼容问题,建议替换为稳定通用版本2020-04-08。
  • URL路径层级错误:Azure File Storage的文件访问URL必须包含文件共享名层级,正确格式为https://<存储账户名>.file.core.windows.net/<文件共享名称>/<目录路径>/<文件名>。你当前给出的URL直接将目录名integration拼接在域名后,缺失了文件共享名段,服务端匹配不到对应资源自然返回404。举个例子,如果你的目标文件存放在名为workspace的文件共享下的integration目录中,正确URL应为https://testgetfilestorage.file.core.windows.net/workspace/integration/TestFile.xml。

快速配置方法

  1. 先修正URL路径:打开Azure Storage Explorer找到目标文件,对照资源层级补全URL中的文件共享名段,确保路径和Storage Explorer中展示的层级完全一致。
  2. 避免手动计算签名出错:直接在Postman的Authorization配置栏,选择授权类型为Azure Storage Service,填入存储账户名testgetfilestorage和对应的访问密钥,Postman会自动完成签名计算、补全x-ms-date等必填请求头,不需要手动拼接签名串。
  3. 确认请求头配置:如果手动配置请求头,除了修正后的x-ms-version,还必须携带和签名计算时间一致的x-ms-date头(格式为RFC1123标准时间,例如Wed, 21 Aug 2024 09:15:00 GMT),以及格式正确的SharedKey类型授权头。

校验小技巧:配置完成后先调用Get File Metadata接口做测试,如果能正常返回文件元数据,再调整为GET方法下载文件内容即可,方便逐层排查问题。

内容的提问来源于stack exchange,提问作者Jack

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.28 12:19:51