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
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| AndroidInstanceIdList | array | Yes | The IDs of the cloud phone instances. | |
| string | Yes | The ID of the cloud phone instance. | acp-34pqe4r0kd9kn**** | |
| SourceFilePath | string | Yes | The path to the file that you want to pull from the cloud phone instance. | /data/a.txt |
| UploadType | string | Yes | The type of the storage service. Note
Currently, only OSS is supported.
| OSS |
| UploadEndpoint | string | Yes | 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 |
| UploadUrl | string | Yes | 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
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 time | Summary of changes | Operation |
|---|---|---|
| 2024-09-13 | The response structure of the API has changed | View Change Details |
