Docs

Torch Object Storage

Upload Object

Overview of Object Uploading (Java SDK)

Overview of Object Uploading (Java SDK)

The Java SDK supports multiple methods for uploading data. The following section provides a brief overview of the parameter constraints for each upload method.

Upload Instructions

Standard Upload: The size of an individual upload object must not exceed 5GiB.

Append Upload: Each append must be at least 128 KiB in size, and the total size of a single object after appending must not exceed 5 GiB.

Multipart Upload: When the file size is large, it is recommended to use multipart upload. The size of all fragments except the final one must be greater than or equal to 5 MiB. The numbering of uploaded fragments is also subject to a range constraint, specifically [1,10000].

Resumable Upload: For large local files, it is recommended to use the resumable upload method, which supports concurrent uploads, progress bars, resumable upload capability, and allows configuration of concurrency and chunk size.

tip

For all the upload methods described above, the TOS Java SDK consistently uses the InputStream class as the data stream parameter for uploading. You may use different types of data streams according to business requirements, such as ByteArrayInputStream, FileInputStream, etc. Subsequent chapters will provide usage instructions and sample code for uploading different data streams for your reference.

During data upload, the SDK emits progress events, which you may monitor according to your business requirements. Subsequent chapters will provide explanations and sample code for monitoring upload progress events for your reference.

During data upload, the SDK restricts the available upload bandwidth. You may configure this setting according to your business requirements. Subsequent chapters will provide usage instructions and sample code for upload client rate limiting for your reference.

Last updated: 2025.09.22 11:34:16