更新时间:2024-10-24 GMT+08:00

流式上传(PUT上传)

使用场景

如果待上传的文本文件、图片、视频等资源小于5GB,您可以选择流式上传,即PUT操作的方式将对象上传到桶中。

PUT上传中参数通过请求头域传递,上传需在URL中指定对象名,请求行为如下所示:

PUT /ObjectName HTTP/1.1

虽然OBS服务支持您将对象上传到指定region的桶里,但是华为云并不感知您对象的具体内容。如果您对象上传行为涉及跨境传输,请您确保使用本服务符合所适用的法律法规要求。

前提条件

  • 至少已创建了一个桶,并且拥有桶的写权限。
  • 如果您需要将文件归类处理,可以先新建文件夹,然后将相关的文件上传到文件夹中。新建文件夹的步骤请参见创建文件夹

使用限制

大小及数量限制:

  • 流式上传可以上传小于5GB的文件,超过5 GB的文件上传请使用6.10.4多段上传
  • 您可以通过设置桶配额限制单个桶上传对象的总容量,详情请参见管理桶配额

命名限制:

对象名命名规则详见对象键命名指导原则

批量操作限制:

支持批量上传功能需要满足以下条件:
  1. OBS桶所在区域支持批量上传功能。当前支持的区域有:中国-香港、亚太-曼谷、亚太-新加坡。
  2. OBS桶的版本号为“3.0”。桶版本号的查看方法请参见OBS 2.0和OBS 3.0的判断方法

文件夹上传限制:

控制台、OBS Browser+、obsutil支持直接上传文件夹。

其他限制:

  • 在未开启多版本控制功能的情况下,
    • 如果新上传的文件和桶内文件重名,则新上传的文件会自动覆盖老文件,且不会保留老文件的ACL等信息;
    • 如果新上传的文件夹和桶内文件夹重名,则上传后会将新老文件夹合并,合并过程如遇重名文件,会使用新上传的文件夹中的文件进行覆盖。
  • 在开启了多版本控制功能的情况下,如果新上传的文件和桶内文件重名,则会在老文件上新增一个版本。关于多版本的详细介绍请参见多版本控制

使用方式

OBS支持通过控制台、API、SDK、OBS Browser+、obsutil方式上传对象。