文档首页/ 对象存储服务 OBS/ 用户指南/ 对象管理/ 对象概述
更新时间：2024-09-21 GMT+08:00
查看PDF
分享

对象概述

对象（Object）是OBS中数据存储的基本单位，一个对象实际是一个文件的数据与其相关属性信息（元数据）的集合体。用户上传至OBS的数据都以对象的形式保存在桶中。

对象包括了Key，Metadata，Data三部分：
  • Key：键值，即对象的名称，为经过UTF-8编码的长度大于0且不超过1024的字符序列。一个桶里的每个对象必须拥有唯一的对象键值。
  • Metadata：元数据，即对象的描述信息，包括系统元数据和用户元数据，这些元数据以键值对（Key-Value）的形式被上传到OBS中。
    • 系统元数据由OBS自动产生，在处理对象数据时使用，包括Date，Content-length，Last-modify，Content-MD5等。
    • 用户元数据由用户在上传对象时指定，是用户自定义的对象描述信息。
  • Data：数据，即文件的数据内容。

通常，我们将对象等同于文件来进行管理，但是由于OBS是一种对象存储服务，并没有文件系统中的文件和文件夹概念。为了使用户更方便进行管理数据，OBS提供了一种方式模拟文件夹。通过在对象的名称中增加“/”，例如“test/123.jpg”。此时，“test”就被模拟成了一个文件夹，“123.jpg”则模拟成“test”文件夹下的文件名了，而实际上，对象名称（Key）仍然是“test/123.jpg”。

上传对象时，可以指定对象的存储类别，如果不指定，默认与桶的存储类别一致。上传后，对象的存储类别可以修改。

您可以根据使用习惯、业务场景通过多种使用方式将文件（数据）上传至桶，OBS最终将这些文件以对象的形式存储在桶中。OBS中桶和对象按区域划分，无论您通过哪种方式使用OBS，都可以通过其他方式在同一区域访问相同的桶及桶内资源。

对象键命名指导原则

虽然您可以在对象键名称中使用任何UTF-8字符，但是按照以下规则命名有助于确保与其他应用程序的最大兼容性。每个应用程序对特殊字符的分析方式可能不同。以下指导原则有助于最大程度符合DNS、Web安全字符、XML分析器和其他API的要求。

以下字符集通常可安全地用于键名称：

字母数字字符（通常也被称为非保留字符）

[0-9a-zA-Z]

特殊英文字符（通常也被称为保留字符）

感叹号（“!”）

连字符（“-”）

下划线（“_”）

句点（“.”）

星号（“*”）

单引号（“'”）

左括号（“(”）

右括号（“)”）

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

4my-organization 
my.great_photos-2014/jan/myvacation.jpg 
videos/2014/birthday/video1.wmv

对保留字符的百分号编码

如果一个保留字符在URI中具有特殊含义（称作“reserved purpose”）, 且URI中必须使用该字符用于其它目的，那么该字符必须百分号编码。OBS服务对非ASCII字符编码必须采用UTF-8编码，否则最终上传至OBS的对象名可能与预期不符。例如，保留字符“/”，如果将其用作URI的路径成分的分隔符, 则是具有特殊含义的保留字符（在OBS中用来分割桶名和对象名）。如果该字符需要出现在URI一个路径成分的内部, 则需要使用三个字符“%2F”或“%2f”代替原本的“/”。保留字符 " "，需要将其编码为“%20”，例如字符串“abc d”，应该编码为“abc%20d”。

可能需要特殊处理的字符

键名中的以下字符可能需要另外进行代码处理：

  • 和符号（“&”）
  • 美元（“$”）
  • 分号（“;”）
  • 冒号（“:”）
  • 加号（“+”）：OBS服务会将请求URI中的“+”解码成空格，因此如果原始的对象键名称中包含“+”，需要编码成%2B之后再放入请求URI中。
  • 空格 : 大量连续空格可能会在某些使用情形中丢失（特别是多个空格）。
  • 等于（“=”）
  • At符号（“@”）
  • 逗号（“,”）
  • 问号（“?”）
  • ASCII字符范围00–1F十六进制（0–31十进制）和7F（127 十进制）

避免在键名中使用以下字符，因为这些字符需要进行大量的特殊处理，才能在所有应用程序间保持一致性。

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

请注意，OBS数据模型是一种扁平结构：您创建桶，桶存储对象。不存在子桶或子文件夹层次结构。但您可以使用键名称前缀和分隔符推断逻辑层次结构（如同OBS控制台一样），OBS控制台支持文件夹的概念。假设您的桶（companybucket）包含具有以下对象键的四个对象：

  • bucket-log/log01.txt
  • cgvbs/test1.txt
  • 2015-10-14_111756.png
  • test1.txt

控制台使用键名称前缀（bucket-log/和cgvbs/）和分隔符（“/”）呈现如下所示的文件夹结构：

2015-10-14_111756.png和test1.txt键没有前缀，因此其对象直接在桶的根级别出现。如果打开cgvbs/文件夹，则您会看到其中包含test1.txt对象。

假设您的桶（companybucket）包含以下对象键的两个对象：

  • obj
  • 1/../obj 或 1/./obj

当您使用API/SDK/OBS Browser+来获取对象则能正确获取，当使用OBS控制台来访问时，浏览器针对相对关系实际发送的请求会访问obj对象，因“../”和“./”在uri中特殊语义，请尽量避免出现在对象键中。此外，当对象名称中包含“../”或“./”时，也不支持在OBS控制台编辑对象（如：转换存储类别、配置生命周期等）。

禁止创建以“..”或“.”开头的对象名。

父主题： 对象管理

相关文档