Updated on 2024-10-24 GMT+08:00

Streaming Upload (PUT)

Scenarios

If the size of an object, such as a text file, image, or video, to be uploaded is smaller than 5 GB, you can use streaming upload (PUT).

Parameters sent by PUT are passed in the request header. You need to specify the object name in the URL. An example request is as follows:

PUT /ObjectName HTTP/1.1

OBS allows you to upload objects to buckets in a specified region, but Huawei Cloud does not detect the object content you uploaded. If your object uploads involve cross-border transfer, ensure that your use complies with relevant laws and regulations.

Prerequisites

  • You have the write permissions to a bucket.
  • If you want to classify files, you can create folders and upload files to different folders. For details, see Creating a Folder.

Constraints

Size and number of objects to upload

  • If a file is smaller than 5 GB, use streaming upload. To upload a file larger than 5 GB, refer to Multipart Upload.
  • You can specify a quota for a bucket to limit its storage capacity. For details, see Managing Bucket Quotas.

Object naming

See Guidelines on Naming Object Keys.

Batch operations

Batch uploads are available only when:
  1. The bucket is in CN-Hong Kong, AP-Bangkok, or AP-Singapore.
  2. The bucket version is 3.0. To view a bucket version, see Checking OBS Version (OBS 2.0 or OBS 3.0).

Folder uploads

You can upload folders using OBS Console, OBS Browser+, or obsutil.

Other

  • Versioning is not enabled for a bucket:
    • If you upload a new file with the same name as the one in the bucket, the new file will automatically overwrite the previous one and the ACL information of the previous file will not be retained.
    • If you upload a new folder with the same name as the one in the bucket, the two folders will be merged, and files in the new folder will overwrite those with the same name in the previous folder.
  • Versioning is enabled for a bucket: If you upload a new file with the same name as the one you previously uploaded to the bucket, a new file version will be added to the bucket. For details, see Versioning.

Ways to Upload

You can use OBS Console, APIs, SDKs, OBS Browser+, or obsutil to upload objects.