Updated on 2024-10-24 GMT+08:00

Resumable Upload

Scenarios

Uploading large files often fails due to poor network conditions or program breakdowns. Re-uploads not only waste resources, but may also fail again. To avoid such issues, you can use the resumable upload API, which works by dividing a file into multiple parts and then uploading them separately. This API helps save resources for re-uploads and improves efficiency by concurrent uploads.

Important Notes

  • To upload objects, you must be the bucket owner or have the required permission (obs:object:PutObject in IAM or bPutObjectb in a bucket policy). For details, see Introduction to OBS Access Control, IAM Custom Policies, and Configuring an Object Policy.
  • If you want to know the regions where OBS is available and the mapping between regions and endpoints, refer to Regions and Endpoints.
  • The file uploaded by the resumable upload API must be larger than 100 KB in size.
  • Before using SDK for resumable upload, you must enable the resumable unload option. Only in this way, the progress of the last upload can be read when you continue the upload process again.

Ways to Upload

You can use SDKs, OBS Browser+, or obsutil to upload objects.