All Products
Search
Document Center

Cloud Phone:FetchFile

Last Updated:Jul 25, 2025

Pulls a file from a cloud phone instance and stores it in Object Storage Service (OSS).

Operation description

Currently, this operation allows you to retrieve files or folders from cloud phone instances and save them directly to OSS.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
AndroidInstanceIdListarrayYes

The IDs of the cloud phone instances.

stringYes

The ID of the cloud phone instance.

acp-34pqe4r0kd9kn****
SourceFilePathstringYes

The path to the file that you want to pull from the cloud phone instance.

/data/a.txt
UploadTypestringYes

The type of the storage service.

Note Currently, only OSS is supported.
OSS
UploadEndpointstringYes

The endpoint of the OSS bucket in which you want to store the pulled file.

Note Set the value to an internal endpoint when the cloud phone instance and the OSS bucket are in the same region to improve upload speed without incurring public traffic fees. Sample endpoint: oss-cn-hangzhou-internal.aliyuncs.com. For more information, see OSS regions and endpoints.
oss-cn-hangzhou.aliyuncs.com
UploadUrlstringYes

The OSS URL of the pulled file.

Note The OSS bucket name must start with "cloudphone-saved-bucket-", for example, "cloudphone-saved-bucket-example". You must also create an OSS directory to store the backup data. Set the value for UploadUrl in this format: oss://<BucketName>/<OSSDirectoryName>.
oss://cloudphone-saved-bucket-cn-hangzhou-165955035250****/backup/

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

Datastring

The objects that are returned.

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

The ID of the request. If the request fails, share this ID with technical support to help diagnose the issue.

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

The ID of the batch task.

t-ehs0yoedj0xe9****

Examples

Sample success responses

JSONformat

{
  "Data": "425F351C-3F8E-5218-A520-B6311D0D****\n",
  "RequestId": "425F351C-3F8E-5218-A520-B6311D0D****",
  "TaskId": "t-ehs0yoedj0xe9****"
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2024-09-13The response structure of the API has changedView Change Details