Skip to Content
Developer GuideObject/File (Object)Download file

Downloading Files

Simple Download

Simple download refers to downloading an already uploaded file (Object) via the GetObject interface of the US3 API. Object download is completed using an HTTP GET request.

  • For detailed information about the simple download API interface, please refer to GetFile.
  • For the URL generation rules of an Object, please refer to US3 Access.
  • If you need to access an Object using a custom domain name, please refer to Accessing US3 via Custom Domain Name.

Resumable Download

US3 supports downloading from a specified position of an Object. When downloading large Objects, you can split the download into multiple sessions. If the download is interrupted, you can resume it from the last completed position when restarting.

Similar to simple upload, you need read permissions for the Object. Resumable download is supported by setting the Range parameter, which is recommended for large Objects. The definition of Range can be referenced in HTTP RFC. If the Range parameter is used in the request header, the response will include the total length of the file and the range returned in this request. For example, Content-Range: bytes 0–9/44 indicates the total file length is 44, and the range returned in this request is 0–9. If the range is invalid, the entire file will be transmitted without mentioning Content-Range in the result, and the return code will be 206.

Viewing File Lists

You can list the files (Objects) uploaded to your storage space (Bucket) via the PrefixFileList interface in the US3 API.

For detailed information about the file list viewing API, please refer to PrefixFileList.

Deleting Files

Deleting a file means removing a file (Object) uploaded to the storage space (Bucket).

US3 allows you to perform the following deletion actions:

  • Single deletion: Delete a specific Object.

  • Automatic deletion: If you need to delete a large number of Objects with certain patterns (e.g., regularly deleting Objects older than a few days or emptying an entire Bucket), it is recommended to use lifecycle management for automatic deletion. After setting lifecycle rules, US3 will automatically delete expired Objects according to the rules, greatly reducing the number of deletion requests you need to send and improving deletion efficiency.

Note: This feature is in the internal testing phase. Please contact technical support if you need to use it.

Upload fileUpload Policy Description