3. Ent对象存储基础：Bucket概念、Object概念、存储区域与访问域名
在开始编排Ent对象存储接口之前，必须透彻理解其核心抽象模型。对象存储并非传统的文件系统目录树，而是扁平的“Bucket — Object”二层结构。本章将拆解这两个核心概念，并说明存储区域（Region）与访问域名（Endpoint）如何共同构成接口调用的基础寻址体系。
3.1 Bucket（存储桶）
Bucket是对象存储的顶层命名空间，类似于文件系统的“根目录”或数据库中的“数据库实例”。所有Object都必须归属于某个Bucket。
| 属性 | 说明 | 约束示例 |
|---|---|---|
| 名称 | 全局唯一（同一存储区域下），DNS兼容 | 仅支持小写字母、数字、短横线，3~63字符 |
| 存储区域 | Bucket创建时指定，不可迁移 | 如：cn-east-1、us-west-2 |
| 权限策略 | 支持ACL、Bucket Policy、IAM | 私有、公共读、公共读写 |
| 版本控制 | 可选开启，用于Object多版本管理 | 开启后不可关闭，只能暂停 |
| 生命周期 | 自动转换存储类或过期删除 | 30天后转为归档，90天后删除 |
关键认知：Bucket不是“文件夹”，它不包含层级结构。所有Object在Bucket内都是扁平存储的，路径分隔符（如
/ ）只是对象键（Key）中的字符，用于模拟目录结构。
3.2 Object（对象）
Object是对象存储的基本数据单元，由三部分组成：数据（Data）、元数据（Metadata）和键（Key）。
- Key：对象的唯一标识符，在Bucket内必须唯一。例如：
images/2025/logo.png。 - Data：文件的实际二进制内容，最大支持5TB（通过分片上传）。
- Metadata：描述数据的属性，包括系统元数据（Content-Type、Content-Length、ETag）和用户自定义元数据（以
x-amz-meta-为前缀）。
接口编排要点：在API编排中，Object的Key决定了存储路径，Metadata中的Content-Type决定了HTTP响应头，直接影响浏览器或客户端的解析行为。编排上传接口时，务必显式设置
Content-Type，避免默认值导致文件下载而非预览。
3.3 存储区域（Region）与访问域名（Endpoint）
存储区域是物理数据中心的地理位置划分，访问域名是客户端与对象存储服务通信的网络入口地址。两者共同决定了接口调用的目标主机。
| 概念 | 作用 | 示例值 |
|---|---|---|
| Region | 标识数据中心的物理位置，影响延迟、合规性、容灾 | cn-east-1（华东）、us-west-2（美西） |
| Endpoint | REST API的访问URL模板，通常包含Region信息 | https://bucket-name.oss.cn-east-1.entcloud.com |
常见错误：在编排接口时，Endpoint拼写错误或Region与Bucket创建时不匹配，会导致
403 Forbidden 或 301 Moved Permanently 重定向。建议将Endpoint配置为环境变量，避免硬编码。
3.4 接口编排中的寻址流程
在Ent对象存储的REST API编排中，一次完整的读写操作遵循以下寻址步骤：
- 确定Region：根据业务部署位置选择最近的存储区域。
- 构造Endpoint：拼接Region对应的访问域名。
- 指定Bucket：在Endpoint后追加Bucket名称。
- 指定Object Key：在Bucket后追加对象键，形成完整URL。
编排示例：上传文件到华东区域的
my-app-assets Bucket，Key为 avatars/user_001.jpg，最终REST API URL为：https://my-app-assets.oss.cn-east-1.entcloud.com/avatars/user_001.jpg
3.5 关键对比：对象存储 vs 传统文件系统
| 维度 | 传统文件系统（如NTFS、ext4） | Ent对象存储 |
|---|---|---|
| 命名空间 | 多级目录树 | 扁平Bucket + Key |
| 数据访问 | 路径遍历（/a/b/c.txt） | REST API直接寻址（HTTP GET） |
| 扩展性 | 受限于单机磁盘容量 | 理论上无限扩展（分布式集群） |
| 元数据 | 文件属性（大小、修改时间） | 丰富的系统元数据 + 自定义元数据 |
| 接口编排 | 系统调用（open/read/write） | HTTP请求（PUT/GET/DELETE/List） |
编排思维转换：从文件系统迁移到对象存储时，不要试图模拟目录树。将Key设计为
prefix/uuid/filename 的扁平模式，利用List API的 prefix 和 delimiter 参数实现“伪目录”查询，性能远优于真实目录遍历。