nav-img
Advanced

How Do I Upload Objects Larger Than 5 GB?

Context

On OBS Console, you can upload a maximum of 100 files in a batch, with a total size of no more than 5 GB. If you upload only one file in a batch, this file cannot exceed 5 GB in size.

Methods

  • 5 GB < Object ≤ 48.8 TB

    If an object is larger than 5 GB, you can use OBS Browser+ or obsutil to upload it. Or you can use the OBS SDKs or API to upload the object (up to 48.8 TB) with a multipart upload.

    • Using obsutil

      With multipart upload, you can upload a single file with the maximum size of 48.8 TB. There is no limit on the number of files that can be uploaded at a time.

      For details about using obsutil to upload objects, see section "Uploading an Object" in the Object Storage Service Tool Guide (obsutil).

    • Using OBS SDKs

      OBS SDK supports uploading a large object with a multipart upload. A multipart upload consists of initiating a multipart upload, uploading parts one by one or concurrently, and assembling parts.

      Table 1 Multipart upload using OBS SDKs

      Language

      References

      Java

      Section "Performing a Multipart Upload" in the Object Storage Service Developer Guide (Java SDK)

    • Using OBS APIs

      You can upload a large object with a multipart upload API. A multipart upload consists of:

      1. Initiating a multipart upload (see section "Initiating a Multipart Upload" in the Object Storage Service API Reference)
      2. Uploading parts (see section "Uploading Parts" in the Object Storage Service API Reference)
      3. Completing a multipart upload (see section "Completing a Multipart Upload" in the Object Storage Service API Reference)