帮助与文档

我们为你提供丰富、详尽的使用指南以及产品文档

FAQ 常见问题

如何提高 Bucket 配额？

每个用户的默认 Bucket 配额为 2 个，用户可以通过提交工单申请提高 Bucket 配额。

不推荐单个用户创建太多的 Bucket

存储空间有文件数量和类型的限制吗？

QingStor 对象存储是面向海量非结构化数据的通用存储，没有针对文件数量和类型的限制。

怎样同步本地目录到对象存储？

可以使用高级命令行工具 qsctl ，其中的 sync 命令支持将本地目录和 QingStor 对象存储目录进行同步，详情请参考 qsctl 文档 。

对象存储可以创建文件夹吗？

QingStor 对象存储的存储空间本质上是一个平级结构，但控制台界面会根据 “/” 来模拟文件系统的层级结构。如果使用 API 调用，可以请求 GET Bucket API ，通过 prefix 和 delimiter 参数来获取按照文件夹归类的文件列表。

有没有针对文件夹操作的接口？

针对文件夹相关的操作，请使用 putObject 接口， object 名称请使用 “/” 结尾(模拟文件夹)。

是否有 API 请求频率限制？

QingStor 对象存储不对 API 请求频率做限制。

是否兼容 AWS S3 的上传工具？

QingStor 对象存储兼容 AWS S3 的主要 API，所以您可以直接使用 AWS S3 相关的上传工具以上传数据到 QingStor 对象存储，兼容工具列表可以参考文档 。

Bucket 能否像 AWS S3 一样 mount 到主机上？

可以使用 s3fs 挂载 QingStor 对象存储的存储空间作为后端存储，具体内容可参考：青云志( QingStor 兼容 AWS S3 接口) 。

qsctl 的同步操作为什么有时不会覆盖文件？

qsctl 在覆盖文件时的处理逻辑为：本地文件更新时间晚于 Bucket 中的 Object 的更新时间才会进行覆盖，当某个文件的更新时间要早于 Bucket 中的对应文件，不会进行覆盖。

qsctl 支持使用 --force 参数来进行强制覆盖。

如何上传较大的文件？

可以使用 PUT 方法上传， 如果文件很大的话， 还可以考虑用分段上传 API 。

PUT 方法上传的 Object 允许最大 5GB; 分段( Multipart ) 上传的 Object 最大可达 50TB( 每个分段最大为 5GB )。如果通过广域网上传，建议几百兆以上文件都用分段上传。

使用分片上传时，如果一个分片上传失败，可以只对这个分片断点续传吗？

不需要中断整个文件的上传，如果某一个分段上传失败了，再次使用 Upload Object Part 操作重新上传这个分段即可。Upload Object Part 操作会覆盖掉之前上传的分段内容。

使用分段上传时，对分段数量和大小是否有限制？

对于单个 Upload 过程的限制可以参考 分段上传限制

使用分段上传时，对分段数量是否有限制？

对于单个 Upload ID ，允许的最大分段个数为 10000 , 关于 Upload ID 的定义，请参考 对象存储 API 文档。

如何批量取消未完成的分段上传 ？

使用对象存储的应用普遍会使用分段上传，假如初始化了分段上传后未调用完成分段上传或者终止分段上传, 这些未完成的上传记录会占用 Bucket 空间。

对于大量的未完成分段上传, 可通过配置 生命周期 规则自动删除。

如何使根目录对匿名用户显示所有的文件？

为了用户的数据安全考虑，假如 Bucket 配置了公开访问权限，我们默认不允许匿名请求访问 list objects 接口，也就是说访问 bucket.zone.qingstor.com 根路径将返回 “permission deny”。如果用户需要这个接口对匿名请求也能返回结果，需要显式做以下配置。

进入对象存储控制台，选择 Bucket，点击”设置” ，进入”存储空间策略”，再点击”添加规则” 操作，选择 list objects ，用户选择 *， 响应动作选择 允许 。

更详细内容请参考文档 控制台用户指南–设置存储空间策略 。

从哪里获取对象存储的 Access Key ？

Access Key 可以在 青云控制台 申请。

更详细内容请参考文档 API 指南–签名验证 。

如何分享文件给没有 Access Key 的用户

可以参考 请求参数签名 文档, 或调用 SDK 相应的生成签名 URL 的函数来生成指定时间段有效的超链接。

将数据分散存储到100个 Bucket，是否会比只存储在1个 Bucket 拥有更好的性能？

这两种情况性能上没有差别。建议根据业务需求去使用不同的 Bucket，或者在单个 Bucket 中划分不同的目录来使用。

QingStor 是否支持服务端压缩和解压缩？

对于下载请求，QingStor 支持文本和图片文件的压缩下载 (请求头需要携带 Accept-Encoding: gzip)，但不支持已压缩文件的解压下载。

对于上传请求，想通过压缩节约上传时间和流量，您需要在客户端自行压缩，上传时携带请求头 Content-Encoding: gzip，下载时 QingStor 会返回压缩文件和响应头 Content-Encoding，客户端根据该响应头自行解压 (浏览器会自动识别这个响应头并进行解压)。

访问对象存储出现 https 证书问题的解决办法

QingStor™ 对象存储使用由 Let's Encrypt 所签发的 HTTPS 证书。Let's Encrypt 是由 Mozilla、Cisco、Akamai、 IdenTrust、EFF 等组织人员发起，主要目的是为了推进网站从 HTTP 向 HTTPS 过度的进程，其证书现在已经可以被所有主流浏览器及操作系统所信任。但是，仍有一些老旧的系统和应用不能兼容, Let's Encrypt 在官网公布了目前已知的兼容和不兼容列表 https://letsencrypt.org/docs/certificate-compatibility

如果您有自己的域名和 HTTPS 证书, 请在 Bucket 设置中绑定自定义域名, 并开启 CDN 加速, 即可上传使用自有 HTTPS 证书, 访问 Bucket 中的文件不受 Let's Encrypt 证书的影响。

针对列表中不兼容情况, 提供如下解决方案:

Android < v2.3.6: 升级 Android 版本到 v2.3.6 以上

Windows XP prior to SP3: 安装 Windows XP SP3 更新包

Java 7 < 7u111 和 Java 8 < 8u101

若您的 JDK/JRE 版本属于以下范围（命令行输入 java -version）：

  • Java 7 < 7u111
  • Java 8 < 8u101

Let's Encrypt 证书将不会被信任并抛出以下异常：

About to connect to 'helloworld.letsencrypt.org' on port 443
javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException
[... 以下输出省略 ...]

如果可以升级 JDK/JRE 版本, 请直接升级您的 JDK/JRE update 版本, 7u111 及 8u101 之后已将 Let’s Encrypt 证书加入信任。如果暂时没法升级, 可以采用如下方式, 向 JRE 中导入 Let's Encrypt 证书:

# 下载 Let's Encrypt 中间证书
wget https://letsencrypt.org/certs/lets-encrypt-x3-cross-signed.pem

# 导入证书
keytool -trustcacerts -keystore "$JAVA_HOME/jre/lib/security/cacerts" -storepass changeit -noprompt -importcert -alias lets-encrypt-x3-cross-signed -file "lets-encrypt-x3-cross-signed.pem"

# 出现 Certificate was added to keystore 即可

对出错的请求原因有疑问

QingStor 对每个请求都生成了唯一的 Request ID, 在返回中会放在 x-qs-request-id 头字段中。 每一个错误返回都有一个 json 格式内容, 包含 Code (返回码) 和 Message (具体原因), 参考 错误信息。 如果用户对错误的原因有疑问, 或者比如调试签名串计算方式之类的问题, 都可以记录好 x-qs-request-id 并在工单提供给我们。