马逊s3云存储接口_技术分享QingStor 对象存储对接指北

编者按：对象存储是面向海量非结构化数据的通用数据存储平台，提供安全可靠、低成本的云端存储服务。作为企业的数据存储和流转中心，可通过浏览器、HTTP RESTful API 、S3 API 、 SDK 和 FTP 等方式高效存取和管理文件，支撑企业丰富的上层业务和数据分析系统使用。

本文，青云QingCloud 开发工程师丁皓将从核心概念出发介绍 QingStor®️ 对象存储，然后介绍 API 和 SDK 及其注意事项，最后总结了一些不了解对象存储的开发者在对接上遇到的常见问题，希望能解决大多数人的困惑。本文主要介绍的是 QingStor®️ 对象存储，但是其他的对象存储概念应当相似，同样可以参考。

1

核心概念

Service

对象存储服务的顶层命名空间。在同一个命名空间下，Bucket Name 是唯一的。每个对象存储 Serivce 都会有一个独立的 Host，比如青云 QingStor®️ 对象存储的 Host 是 qingstor.com。私有云用户在接入时需要将 Host 修改为对应的环境配置的 Host。

Zone

每个对象存储 Service 都会至少有一个 Zone，每个 Zone 会有一个唯一的标识。比如青云公有云目前线上运维的对象存储 Zone 包括：pek3a，pek3b，sh1a 和 gd2。

Bucket

Bucket 是用户申请的存储空间，每个 Bucket 都会属于一个 Zone，每个 Bucket 在同一个 Service 下都是全局唯一的，每个 Bucket 彼此之间完全隔离。

Bucket 将会是域名的一部分，因此 Bucket 在命名时需要遵守以下规则：

• 遵守 DNS 命名规则

• 长度在 6 ~ 63 之间

• 只能包含小写字母，数字和连接字符 -

• 开头和结尾只能是小写字母或数字

Object

Object 是用户访问数据的最小单元，每个 Object 都会属于一个 Bucket，每个 Object 在同一个 Bucket 下都是唯一的。单个 Object 最大 50TB。

Object 将会是 URL 的一部分，因此 Object 在命名需要遵守以下规则：

• 长度须在 1-1023 字节之间

• 第一个字符不能是反斜杠 /

• 须用 UTF-8 编码

在发送请求的时候，Object Key 部分需要进行 URL 编码。

2

API 介绍

对象存储对外暴露的是 RESTfu