All Products
Search

This Product

    Drive and Photo Service:DownloadFile

    Document Center

    Drive and Photo Service:DownloadFile

    Last Updated:May 27, 2026

    Downloads a file.

    Operation description

    Try it now

    Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

    Test

    RAM authorization

    No authorization for this operation. If you encounter issues with this operation, contact technical support.

    Request syntax

    GET /v2/file/download HTTP/1.1

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    domain_id

    string

    Yes

    share_id

    string

    No

    The ID of the share. If you access a file by using a share link, you must authenticate with the x-share-token header and specify this parameter. In this case, the drive_id parameter is not applicable. Otherwise, you must authenticate by using AK/SK or an access_token and specify the drive_id parameter. You must specify either share_id or drive_id.

    7JQX1FswpQ8
    drive_id

    string

    No

    The ID of the drive.

    1
    file_id

    string

    Yes

    The ID of the file.

    9520943DC264
    image_thumbnail_process

    string

    No

    The image processing style. Specifying this parameter redirects the request to the URL of the processed thumbnail.

    image/resize,m_fill,h_128,w_128,limit_0
    video_thumbnail_process

    string

    No

    The video processing style. Specifying this parameter redirects the request to the URL of the processed thumbnail.

    video/snapshot,t_7000,f_jpg,w_800,h_600,m_fast
    office_thumbnail_process

    string

    No

    The document processing style. Specifying this parameter redirects the request to the URL of the processed thumbnail.

    image/resize,m_lfit,w_256,limit_0/format,jpg|image/format,webp

    Response elements

    Element

    Type

    Description

    Example

    None defined.

    Examples

    Success response

    JSON format

    {}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.