Uploading an Object

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 files to select files.

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

   If the bucket has server-side encryption enabled, any object you upload will inherit the KMS encryption from the bucket by default.

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.

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 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. Select the target object and choose More > Change Storage Class on the right.
   

   You can also select multiple objects at a time and choose More > Change Storage Class above the object list, to batch change their storage classes.

   Storage classes of unrestored Archive objects cannot be changed in a batch.

4. Select the desired storage class and click OK.

• You can manually change objects between storage classes. Changing objects from Infrequent Access or Archive to other storage classes incurs restore costs. Select an appropriate change option based on your actual needs.
  • From Standard to Infrequent Access, Archive
  • From Infrequent Access to Standard, Archive
  • From Archive to Standard, Infrequent Access. Before changing Archive objects, you must restore them first.
• After an object is changed to Archive, 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 More > 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.