用户可以上传对象至已有的存储桶中。上传方式区分普通上传、分片上传与追加写。
- 媒体存储管理控制台支持批量上传文件,单次最多支持100个文件上传,单个文件大小最大支持5GB。
- 通过SDK或API的PUT上传或者POST上传,可以上传小于5GB的文件,推荐上传小于2GB的文件。
- 通过SDK或API的分片上传,可以上传小于50000GB(约48.8TB)的文件。
- XstorBrowser支持直接上传文件夹。
- 在未开启多版本控制功能的情况下,如果新上传的文件和桶内文件重名,则新上传的文件会自动覆盖旧文件。
- 在未开启多版本控制功能的情况下,对象删除后不可恢复。
- 使用UTF-8编码。
- 命名长度范围为1~1023字节。
- 推荐可用于文件名字符集为[0-9a-zA-Z]、感叹号"!"、左括号"("、右括号")"、连字符"-"、下划线"_"、星号"*"、单引号"'"、句号"."。
- 如果上传的对象名带有中文,在访问或请求这个对象时中文部分将会按照URL Encode规则把中文转换为百分号编码。
媒体存储支持普通上传的方式。可以上传小于5GB的文件,推荐上传小于2GB的文件。
通过分片上传,用户可以最大程度提高上传效率同时避免任务失败。分片上传允许将单个对象按照一定的大小分割成多个数据分片,作为一组分片分别上传。
用户可以独立上传或者按任意顺序上传对象的分片。如果其中某个分片传输失败,可以重新传输该分片且不会影响其他分片。
当对象的所有分片都上传后,媒体存储会将这些分片合并起来,然后创建该对象。
- 大文件加速上传,对于大小超过5GB的对象推荐使用分片上传以加快上传速度
- 网络不稳定或较差时,推荐使用分片上传,当出现上传失败的时候,用户仅需重传失败的分片。
- 初始化分片上传任务:开始分片上传时,媒体存储将首先初始化分片上传任务并返回分片上传的唯一标识符uploadId。无论您何时上传分片、合并分片或取消分片上传任务,都必须包括此上传uploadId。
- 上传每个分片:上传分片时,每一个分片的顺序是通过上传过程中指定的partNumber来确定,所以除了指定uploadId,还必须指定分片编号partNumber,partNumber的数量在初始化时自动决定。用户可以并发上传这些碎片,可结合本地网络状况和设备能力综合考虑并发个数。
- 合并分片:合并分片时,媒体存储通过按升序的分片编号规范化分片来创建对象。成功完成请求后,分片将不再存在。用户可以选择取消分片上传任务,之后无法再次使用该上传ID上传任何分片,同时已上传的部分将形成文件碎片并占用存储空间。如果任何分片上传已在进行中,即使用户已执行中止操作,它们仍可以上传成功或失败。
- 分片上传过程被中断后,如果不再需要这些分片,请通过控制台桶详情中的未完成上传页清空碎片按钮,手动删除无用的分片,以免产生额外存储费用。可参考:碎片管理。
- 暂停和恢复对象上传:用户可以在任务过期时间内随时上传对象分片,控制台默认过期时间为1天。
- 合并分片阶段,若未对所有分片进行合并,那么未被合并的分片将被自动删除且无法恢复。因此在合并分片之前请仔细核对所有分片,确保没有遗漏的分片。
- 在未开通版本控制的存储桶中,上传同名对象会覆盖媒体存储中已有对象。
追加写可以对桶中的一个对象进行追加写操作,如果该对象已经存在,执行该操作则向文件末尾追加内容,否则将创建对象。