Simple Download
Last updated: 2025-10-13 16:29:32
Scenarios
You can directly initiate a request to download objects in COS. The following features are supported:
Download a complete object: Download the complete object data by initiating a GET request.
Download a part of an object: Use the Range request header in a GET request to retrieve a specific range of bytes of an object. Retrieving multiple ranges is not supported.
The object's metadata will be returned as HTTP response headers along with the object content. GET requests support overriding some metadata values using URL parameters, such as the Content-Disposition response value. Modifiable response headers include:
Content-Type
Content-Language
Expires
Cache-Control
Content-Disposition
Content-Encoding
How to Use
Using COS console
Downloading a single object
1. Log in to the COS console.
2. Click Bucket List on the left sidebar.
3. Locate the bucket where the object resides and click the bucket name.
4. Click File List on the left.
5. Find the target object and click the corresponding Download button.
Click Download in the Operation column on the right of the object.
Select the object and click More Actions > Download at the top.
Click Details in the Operation column on the right of the object to enter the file details page, and then click Download Object.
You can also click Copy Temporary Link, paste the link into a browser, and press Enter.
Note:
If the bucket where the object is stored is private read/write, a signature will be automatically calculated and added at the end of the address copied here. For more information on how to generate a signature, see Request Signature.
The temporary link with a signature is valid for 1 hour from the moment you click to view the Details. You can refresh the validity period of the signature by clicking Refresh.
By default, if the downloaded object can be directly opened in the browser, then accessing the temporary URL will directly preview the object rather than downloading it.
Downloading objects or folders in batches
Note:
You can only download individual objects in the COS console. To download multiple objects or folders in batches, we recommend you install the COSBrowser client. Here is how to download objects or folders in batches in the console in conjunction with the COSBrowser client.
1. Log in to the COS console.
2. Click Bucket List on the left sidebar.
3. Locate the bucket where the object resides and click the bucket name.
4. Click File List on the left.
5. Select multiple objects and click More Actions > Download at the top.
6. Follow the on-screen prompts to install or launch the COSBrowser client and log in.
7. After opening COSBrowser, select the file storage location. Selected files will automatically proceed to the download queue and start the download. You can click the upper right Transmission icon to view and download progress.
Using the REST API
Using SDKs
Directly call the object download method in the SDK. For more information, see the SDK documentation for the corresponding programming language below:
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No
Feedback