veImageX 存储 Key 通用字符规则--veImageX-火山引擎

文档中心

立即注册

veImageX

请输入

开发指南

veImageX 存储 Key 通用字符规则

在使用 veImageX 服务进行上传、文件命名、多文件压缩、获取资源等操作时，都会涉及存储 Key 的命名。本文列出 veImageX 存储 Key 命名所需遵循的通用字符规则。

veImageX 底层基于对象存储服务，没有传统文件系统中的文件和文件夹概念。为了方便用户管理数据，veImageX 提供了一种模拟文件夹的方式：通过在对象的名称中增加 / 模拟文件夹结构。例如 test/123.jpg，其中 test 就被模拟成一个文件夹，123.jpg 则是 test 文件夹下文件。实际上，对象名称（存储 Key）仍然是 test/123.jpg。

编码方式和长度限制

veImageX 存储 Key 有一些限制：

必须使用 UTF-8 编码。
长度必须在 1～1023 字节之间。

命名指导原则

以下为 veImageX 存储 Key 命名规范，由于每个应用程序对特殊字符的分析方式可能不同，建议您在命名前确认与其他应用程序的兼容性。

安全字符

字母数字字符：[0-9a-zA-Z]
中文字符
特殊字符：
- 感叹号 !
- 连字符 -
- 下划线 _
- 句点 .
- 星号 *
- 单引号 '
- 左括号 (
- 右括号 )
- 加号 +
- 和符号 &
- 美元符号 $
- 分号 ;
- 冒号 :
- 空格
- 等于 =
- At 符号 @
- 逗号 ,
- 正反斜线 /、\
  注意
  - 不能以正斜线 / 和反斜线 \ 开头或结尾。
  - 不能出现连续正斜线 //。

需要特殊处理的字符

存储 Key 中的以下字符需要进行百分号编码处理：

问号 ?
左大括号 {
右大括号 }
插入符号 ^
百分比符号 %
重音符/反勾号 `
左方括号 [
右方括号 ]
双引号 "
大于号 >
波浪号 ~
小于号 <
井号 #
竖线 |

不建议使用字符

请避免在存储 Key 中使用以下字符。

不支持 \a、\b、\t、\n、\v、\f、\r 字符。
说明
上传时使用上述字符可以成功，但在分发及其他场景可能失败，因此不建议使用。
不能以正斜线 / 和反斜线 \ 开头或结尾。
不能出现连续正斜线 //。

最近更新时间：2025.03.05 11:59:43

这个页面对您有帮助吗？

有用

无用