QingStor 对象存储对接指北

💡 原文中文,约5500字,阅读约需13分钟。
📝

内容提要

本文介绍了QingStor对象存储的核心概念、API和SDK。对象存储的命名空间包括Service、Zone和Bucket,每个Bucket在同一Service下唯一。API采用RESTful风格,支持HTTP和HTTPS访问。常见问题包括断点续传、超大文件上传和文件夹模拟。访问时需注意认证和CORS配置,以确保安全性。

🎯

关键要点

  • QingStor对象存储的核心概念包括Service、Zone和Bucket,每个Bucket在同一Service下唯一。

  • 对象存储的API采用RESTful风格,支持HTTP和HTTPS访问,输入输出均为JSON格式。

  • 常见问题包括断点续传、超大文件上传和文件夹模拟,需注意认证和CORS配置以确保安全性。

  • 对象存储的每个Object最大可达50TB,且在同一Bucket下唯一。

  • 支持通过Virtual-host Style和Path Style两种方式访问对象存储,且兼容S3模式。

  • 在提工单时需提供完整信息,包括Zone、Bucket、SDK和request_id,以便快速解决问题。

🔎

延伸解读

对象存储的命名规则

在使用QingStor对象存储时,命名规则至关重要。每个Bucket和Object的命名都需遵循特定的格式,以确保在同一Service下的唯一性。Bucket名称必须遵循DNS命名规则,且长度在6到63个字符之间。Object名称则需使用UTF-8编码,长度在1到1023字节之间。正确的命名不仅影响访问,还可能影响数据的管理和检索效率。

API使用注意事项

QingStor的API采用RESTful风格,使用时需特别注意请求的认证和时间戳。所有请求必须携带正确的Date和Host信息,且时间误差不能超过15分钟。此外,返回的x-qs-request-id Header在遇到问题时非常重要,提供该信息可以加速问题的解决。开发者在使用API时应仔细阅读文档,确保请求格式和参数的正确性。

CORS配置的重要性

在浏览器端访问QingStor对象存储时,CORS配置是一个常见的障碍。若未正确配置Bucket的CORS,可能会导致访问失败。因此,开发者在进行前端开发时,需确保CORS设置符合需求,以避免因跨域问题影响用户体验。建议在开发初期就进行CORS配置的测试,以减少后期的调试工作。

延伸问答

QingStor对象存储的核心概念是什么?

QingStor对象存储的核心概念包括Service、Zone和Bucket,每个Bucket在同一Service下唯一。

如何通过API访问QingStor对象存储?

可以通过RESTful风格的API访问QingStor对象存储,支持HTTP和HTTPS协议,输入输出均为JSON格式。

QingStor对象存储支持哪些文件上传方式?

QingStor对象存储支持断点续传和分段上传,单个分段最大5GB,单文件最大可达50TB。

如何处理CORS配置以确保安全性?

在浏览器端访问对象存储时,需要正确配置Bucket的CORS,以避免CORS相关的报错。

在提工单时需要提供哪些信息?

提工单时需提供Zone、Bucket、SDK和request_id等完整信息,以便快速解决问题。

如何模拟文件夹结构在QingStor对象存储中?

对象存储没有层次结构,但可以通过指定分隔符将带有相同分隔符的Object组织在一起,模拟出文件夹。

🏷️

标签

➡️

继续阅读