云平台开发辅助

S3 URL 转换

解析单条 S3 地址,或用存储桶与原始对象键构建地址;签名链接保持原样。

S3 URL 转换

地址

对象信息与地址

地址仅在当前浏览器内处理,不向 S3 或自定义端点发送请求。

输出选项

地址中明确的区域优先;回退值不代表查到了存储桶的真实区域。

自定义端点必须使用路径式,只填写 HTTPS 源站,不带路径、查询或凭证。

结果待更新,已禁用导出。

控制台复制的对象链接和应用配置里的存储路径,可能只是同一对象的两种写法。S3 URL 转换先展开存储桶名称与解码后的对象键,让你核对前缀、空格和连续斜杠,再选择客户端需要的地址形式。它不会把对象键当成本地文件路径自动整理。

为什么使用 S3 URL 转换

比较两种寻址方式

S3 URL 转换把同一个存储桶放到主机名或路径开头,对象键保持一致。排查客户端的路径式选项时,可以直接对照两种结构,确认改变的是寻址方式,而不是桶内的对象。

相同的存储桶和对象连接到两种地址结构,存储桶分别位于主机名和路径中。

保留签名链接的原始文本

预签名 URL 中的主机、路径和参数可能参与签名。检测到签名字段后,只展示原始链接与提取的信息,禁用 URI 转换出口,避免把改写后的链接误当成仍然有效的授权地址。

原地址被锁定保持不变,旁边独立展示提取出的存储桶与对象键。

先确认编码、区域和更新时间

01

区分完整地址与原始键

地址中的 %252F 只解码成字面量 %2F,不会再变成斜杠。字段模式则把输入视为原始名称;在这里填写 %2F,输出会是 %252F。

02

核对区域的来源

输入中明确的区域优先于回退参数。s3:// URI 和全局端点没有提供区域时,需要自行确认默认的 us-east-1。自定义端点必须选路径式,不能据此推断桶的实际位置。

03

在结果更新后再导出

输入或选项改变会立即禁用导出。自动转换等待 350 毫秒;关闭开关后可点击转换或按 Ctrl/Cmd+Enter。示例和清空先展示预览,应用后支持一次撤销。

围绕对象身份解析和构建

地址解析与字段构建

S3 路径解析支持普通 HTTPS 地址转成 S3 URI,也支持直接填写存储桶名称和原始对象键。空键表示存储桶根地址;对象前缀属于键本身,不会被拆成另一层存储桶。

区域与端点

S3 URI 转 HTTPS 时支持商业区域和中国区域的域名。可识别标准区域、历史 s3-region 和 dualstack 输入;输出使用常规区域端点,不承诺保留输入的双栈网络特性。

查询参数逐字保留

普通 HTTPS 结果保留重复参数、原始顺序、空值、加号和百分号编码写法。S3 URI 只保留桶与键;下载的 JSON 报告另存原始查询串,便于检查 versionId 等参数。

支持范围与不能推断的事情

不验证访问和授权
工具不会发送 GET 或 HEAD 请求,不查询桶位置,不生成签名,也不验证到期时间。地址结构正确不代表对象存在、公开可读或当前凭证具有访问权限。
仅支持列明的端点
不支持 ARN、控制台、CloudFront、网站端点、Access Point、Outposts、Express 和 accelerate。自定义域名只有在明确填写 HTTPS 源站并选择路径式后才会解析。
对象键不作路径归一化
独立的 . 和 .. 段以及控制字符会被拒绝,避免浏览器折叠路径后选中另一个对象。原始字段中的首尾空格、开头斜杠和连续斜杠会保留;精确键名 soap 要使用路径式。
编码和长度限制
完整地址里的空格和字面 # 必须编码。百分号只按 UTF-8 解码一次,加号不会变成空格。输入上限是 16,384 个字符,对象键上限是 1,024 个 UTF-8 字节。
通用存储桶命名检查
只接受符合当前小写 DNS 语法与保留名称限制的通用存储桶名。虚拟托管式下带点的名称会提示 TLS 限制;这些检查无法证明名称可注册或属于当前用户。

S3 URL 转换常见问题

虚拟托管类型与路径类型的 S3 URL 有什么区别?

虚拟托管类型把存储桶放在 s3 前面的主机名里;路径类型把桶名放在端点后的第一段路径里。同一个桶和键可以用两种方式表示,但访问权限并不会随格式变化。自定义端点在本工具里必须使用路径式。

对象键中的百分号编码需要解码吗?

从完整地址提取对象键时解码一次。例如 a%20b 表示 a b,而 a%2520b 表示字面量 a%20b。加号始终保留为加号。字段模式输入的是原始键名,工具会在生成地址时编码。

预签名 URL 可以提取存储桶和对象键吗?

可以。发现签名或凭证相关参数后,工具提取桶与键并逐字保留原始 URL,同时禁用 S3 URI 导出。即便签名字段不完整,也按这个保守规则处理;这不等于签名校验通过。

为什么打开有权限的 S3 对象 URL 仍然显示访问被拒绝?

对象链接本身不授予访问权限。应检查使用的身份、桶策略、对象权限和对象是否存在。改变地址写法不能让私有对象公开,本工具也不会尝试请求对象来判定 403 的具体原因。

为什么预签名 URL 会在指定的到期时间之前过期?

临时凭证可能早于链接指定的有效期过期,凭证撤销或策略条件也可能阻止访问。应通过有权限的 AWS 工作流重新生成链接,不能靠修改旧链接里的到期参数来延长授权。

遇到了未说明的地址格式?

继续核对下一条地址

使用 S3 URL 转换核对解码后的对象键,再复制客户端所需的寻址形式。签名输入请始终以保留的原地址为准。