Updated on 2024-05-31 GMT+08:00

Uploading an Object

This section describes how to upload local files to OBS over the Internet. These files can be texts, images, videos, or any other type of files.

Constraints

OBS Console puts limits on the size and number of files you can upload.

  • In regions that support batch uploads, a maximum of 100 files can be uploaded at a time, with a total size of no more than 5 GB.
  • In regions that do not support batch uploads, only one file can be uploaded at a time, with a size of no more than 50 MB.

Therefore, for a single file to be uploaded, its maximum size can be 5 GB in a batch upload or 50 MB in a single upload.

OBS Browser+ allows you to upload up to 500 files at a time. There is no limit on the number of files you can upload using obsutil at a time.

Batch upload is available only when the following condition is met:

The bucket version is 3.0. To view the bucket version, see Viewing Basic Information of a Bucket.

If versioning is disabled for your bucket and you upload a new file with the same name as the one you previously uploaded to your bucket, the new file automatically overwrites the previous one and does not retain its ACL information. If you upload a new folder using the same name that was used with a previous folder 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.

After versioning is enabled for your bucket, if the new file you upload has the same name as the one you previously uploaded to the bucket, a new file version will be added in the bucket. For details, see Versioning.

Prerequisites

  • At least one bucket has been created.
  • If you want to classify files, you can create folders and upload files to different folders. For details, see Creating a Folder.

Procedure

  1. In the navigation pane of OBS Console, choose Object Storage.
  2. In the bucket list, click the bucket you want to operate to go to the Objects page.
  3. Go to the folder where you want to upload files and click Upload Object. The Upload Object dialog box is displayed.

    Batch upload is used as an example here. If the region you are using supports only single upload, perform operations as instructed.

    If the files that you want to upload to OBS are stored in Microsoft OneDrive, it is recommended that the names of these files contain a maximum of 32 characters to ensure compatibility.

    Figure 1 Uploading objects

  4. Select a storage class. If you do not specify a storage class, the objects you upload inherit the default storage class of the bucket.

    An object can have a different storage class from its bucket. You can specify a storage class for an object when uploading it, or you can change the object storage class after the object is uploaded.

  5. In the Upload Object area, drag and drop the files or folders you want to upload.

    You can also click add file in the Upload Object area to select files.

  6. (Optional) Select KMS encryption to encrypt the uploaded file. For details, see Uploading an Object in Server-Side Encryption Mode.

    If the default encryption has been enabled for the bucket, the objects you uploaded will automatically inherit the bucket's KMS encryption settings.

  7. (Optional) To configure metadata, click Next: (Optional) Configure Advanced Settings.

    Add metadata ContentDisposition, ContentLanguage, WebsiteRedirectLocation, ContentEncoding, or ContentType as needed. For more information, see OBS Object Metadata. Metadata is a set of name-value pairs. The metadata value cannot be left blank. You can add two or more metadata entries by clicking Add.

  8. Click Upload.