对象（key）命名规则

Posted 2021-12-21 hlc-123

创建对象时，要指定 Key 名称，它在存储桶中唯?一地标识该对象。如果在指定的 Bucket 内已经有相
同 Key 的对象，?用户上传的新对象会覆盖原来的对象。以下指导原则有助于最?大程度符合 DNS、
Web 安全字符、XML 分析器?和其他 API 的要求。为了了能够更更好的使?用EOS对象存储，在进?行行对象命
名的时候请仔细阅读并遵守以下命名规则：

• 键的名称是?一序列列的 Unicode 字符，它是 UTF-8 编码格式。
• 最?大为 1024 个字节
• 以下字符集通常可安全地?用于键名称：
• 字?母数字字符 0-9，a-z，A-Z
• 特殊字符 !、-、_、.、*、‘、( 和 )

以下是有效对象键名称的示例例：

• 4my-organization
• my.great_photos-2014/jan/;
• videos/2014/birthday/video1.wmv

键名称中的以下字符可能需要另外进?行行代码处理理，并且可能需要以?十六进制形式在 URL 中编码
或引?用（URL编码 ?方式）。其中部分字符是不不可打印的字符，浏览器?可能?无法处理理它们，这也需
要特殊处理理：

• 表示和的符号(“&”)
• 美元 (“$”)
• ASCII 字符范围 00–1F ?十六进制 (0–31 ?十进制) 和 7F (127 ?十进制)
• “At”符号 (“@”)
• 等于 (“=”)
• 分号 (“;”)
• 冒号 (“:”)
• 加号 (“+”)
• 空格 – ?大量量连续空格可能会在某些使?用情形中丢失 (特别是多个空格)
• 逗号 (“,”)
• 问号 (“?”)问号 (“?”)

需要避免的字符：

• 反斜杠 ("")
• 左?大括号 (“”)
• 不不可打印的 ASCII 字符 (128–255 ?十进制字符)
• 插?入符号 (“^”)
• 右?大括号 (“”)
• 百分?比字符 (“%”)
• 重?音符/反勾号 (“`”)
• 右?方括号 (“]”)
• 引号
• “?大于”符号 (“>”)
• 左?方括号 (“[”)
• 波浪字符 (“~”)
• “?小于”符号 (“<”)
• “井号”字符 (“#”)
• 竖线 (“|”)

不不能以“/”或“\”字符开头，如果 Key 使?用 "/" 或者 "" 开头时，上传对象将会报错。