All Products
Search

This Product

    Cloud Phone:FetchFile

    Document Center

    Cloud Phone:FetchFile

    Last Updated:Apr 13, 2026

    Fetches files from a cloud phone to Object Storage Service (OSS).

    Operation description

    This operation fetches only files or folders from a cloud phone to Object Storage Service.

    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 parameters

    Parameter

    Type

    Required

    Description

    Example
    AndroidInstanceIdList

    array

    Yes

    A list of cloud phone instance IDs.

    string

    No

    The ID of a cloud phone instance.

    acp-34pqe4r0kd9kn****

    SourceFilePath

    string

    Yes

    The path of the file or folder to fetch from the cloud phone.

    /data/a.txt
    UploadType

    string

    Yes

    The type of storage service for the fetched file.

    Note

    Currently, only Object Storage Service (OSS) is supported.

    OSS
    UploadEndpoint

    string

    Yes

    The endpoint for uploading files to OSS.

    Note

    If the cloud phone and the destination OSS bucket are in the same region, you can use an internal endpoint to accelerate the transfer and avoid public network charges. For example, in the China (Hangzhou) region, use oss-cn-hangzhou-internal.aliyuncs.com. For a complete list of endpoints, see OSS regions and endpoints.

    oss-cn-hangzhou-internal.aliyuncs.com
    UploadUrl

    string

    Yes

    The destination URL in OSS.

    Note

    The destination bucket name must be prefixed with cloudphone-saved-bucket-. For example, cloudphone-saved-bucket-example. You must also create a folder in the bucket to serve as the destination directory. The UploadUrl must follow the format: oss://<bucket_name>/<folder_name>.

    oss://cloudphone-saved-bucket-example/received

    ClientToken

    string

    No

    A client-generated token, up to 100 characters long, that ensures the idempotency of the request.

    425F351C-3F8E-5218-A520-B6311D0D****

    Response elements

    Element

    Type

    Description

    Example

    object

    The response object.

    Data

    array<object>

    An array of results, with one entry for each instance specified in the request.

    425F351C-3F8E-5218-A520-B6311D0D****

    object

    The result for a single cloud phone instance.

    AndroidInstanceId

    string

    The ID of the cloud phone instance.

    acp-34pqe4r0kd9kn****
    TaskId

    string

    The ID of the task created for this specific instance.

    t-bp67acfmxazb4p****
    RequestId

    string

    The request ID. Provide this ID when contacting support for troubleshooting.

    425F351C-3F8E-5218-A520-B6311D0D****
    TaskId

    string

    The batch task ID.

    t-ehs0yoedj0xe9****

    Examples

    Success response

    JSON format

    {
  "Data": [
    {
      "AndroidInstanceId": "acp-34pqe4r0kd9kn****",
      "TaskId": "t-bp67acfmxazb4p****"
    }
  ],
  "RequestId": "425F351C-3F8E-5218-A520-B6311D0D****",
  "TaskId": "t-ehs0yoedj0xe9****"
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.