对象存储日志存储功能的对象名称启用 URL 编码公告--对象存储-火山引擎

文档中心

导航

对象存储日志存储功能的对象名称启用 URL 编码公告

最近更新时间：2025.10.30 15:22:13首次发布时间：2025.10.30 15:22:13

为了给您提供更加优质的服务，火山引擎对象存储产品预计将于 2025 年 12 月 1 日对日志存储功能所生成的日志文件中的对象名称 (Object) 字段进行 URL 编码。

预计变更时间

2025 年 12 月 1 日，具体变更时间请以控制台变更为准。

日志存储功能支持将 TOS 的访问日志以文件的形式保存到指定的存储桶，便于您进行审计对账。本次变更对日志存储功能所生成的日志文件中的对象名称（Object）字段进行了 URL 编码升级，说明如下：

变更前：对象名称在日志存储功能所生成的日志文件中以原始格式保存，未进行任何编码处理。例如 data/file/日志存储.txt 文件在日志文件中的存储格式为：
```
"2025-07-26T16:07:19.464+08:00","data/file/日志存储.txt","bucketName"
```
变更后：TOS 对日志存储功能所生成的日志文件中的对象名称进行了 URL 编码处理。该 URL 编码遵循 RFC 3986 规范。例如data/file/日志存储.txt 文件在日志文件中的存储格式为：
```
"2025-07-26T16:07:19.464+08:00","data%2Ffile%2F%E6%97%A5%E5%BF%97%E5%AD%98%E5%82%A8.txt","bucketName"
```
并且日志文件还新增 LogVersion 字段，用于标识日志文件中对象名称的编码方式，取值说明如下：
- 1.0 ：日志文件中的对象名称未进行任何编码处理。
- 2.0 ：日志文件中的对象名称进行了 URL 编码。

对于在 2025 年 12 月 1 日前启用日志存储功能的存储桶，日志文件中的对象名称仍保持原始格式，未进行任何编码处理，不受此次变更影响。如果您需要对对象名称进行 URL 编码，您可以提交工单或联系客户经理咨询。
对于在 2025 年 12 月 1 日及之后启用日志存储功能的存储桶，日志文件中的对象名称默认会进行 URL 编码。如果您的业务逻辑需要从日志文件中读取原始对象名，则您需要在程序中增加 URL 解码步骤，避免因编码字符导致名称解析错误。详细介绍，请参见对象名称解码示例。

如果您对变更有任何疑问，您可以提交工单或联系客户经理咨询。