在使用 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 字符。

  说明

  上传时使用上述字符可以成功，但在分发及其他场景可能失败，因此不建议使用。

• 不能以正斜线 / 和反斜线 \ 开头或结尾。
• 不能出现连续正斜线 //。