Updated on 2024-03-04 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.

Limitations and Constraints

  • OBS Console allows you to upload files in a batch. Up to 100 files can be uploaded at a time, with the total size of no more than 5 GB. If the file size exceeds 5 GB, but no larger than 48.8 TB, use tools (such as OBS Browser+ and obsutil) or the multipart upload of OBS SDKs and APIs for upload.
  • 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 file 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 namesake files 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 Overview.

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 bucket list, click the bucket you want to operate. The Overview page is displayed.
  2. In the navigation pane, choose Objects.
  3. Go to the folder where you want to upload files and click Upload Object. The Upload Object dialog box is displayed.

    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.

  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, uploaded objects are automatically encrypted.

  7. Click Upload.

Related Operations

When uploading an object, you can specify a storage class for it. After the object is uploaded, you can also change its storage class by doing as follows:

  1. In the bucket list, click the bucket you want to operate. The Overview page is displayed.
  2. In the navigation pane, choose Objects.
  3. Select the target object and choose More > Change Storage Class on the right.

  4. Select the desired storage class and click OK.
  • You can manually change objects between storage classes:

    • From Standard to Warm, or Cold
    • From Warm to Standard, or Cold
    • From Cold to Standard, or Warm. Before changing Cold objects, you must restore them first.

      Changing objects from Warm or Cold to other storage classes incurs restore costs. Select an appropriate change option based on your actual needs.

  • After an object is changed to Cold, its restore status changes to Unrestored.
  • You can also configure a lifecycle rule to change the storage class of an object. For details, see Configuring a Lifecycle Rule.

Follow-up Procedure

You can click Copy Path on the right of an object to copy its path.

You can share the path with others. Then they can open the bucket where the object is stored and enter the path in the search box above the object list to find the object.