All Products
Search
Document Center

Cloud Phone:RecoverAndroidInstance

Last Updated:Jan 15, 2026

Restores a full instance backup to another cloud phone instance.

Operation description

  1. When you restore a full instance, the system restarts the instance to ensure a successful restoration. A restart is not required if you restore only applications and data. Make sure the instance is in an active state. Do not perform any operations on the instance during the restoration process. Otherwise, the restoration may fail.

  2. Ensure that the backup file can be used to restore the instance properly. After a restoration is complete, check that all your data is complete and all features are working properly. Do not delete the original backup file or reset the source instance until you have verified the restored data. Otherwise, you may lose your data.

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  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

BackupFileId

string

No

The ID of the backup file.

bf-azhps4rdyi2th****

AndroidInstanceIdList

array

Yes

A list of instance IDs.

string

No

The instance ID.

acp-ig2bdpk374l12****

UploadEndpoint

string

No

The region where the backup is located.

oss-cn-hangzhou-internal.aliyuncs.com

UploadType

string

Yes

The upload type.

OSS

BackupFilePath

string

Yes

The OSS URL where the backup file is uploaded.

oss://cloudphone-saved-bucket-cn-hangzhou-****/backupDir/acp-ig2bdpk374l12****_2024052014****.ab

Response elements

Element

Type

Description

Example

object

PlainResult

Data

array<object>

The returned result objects.

object

The returned result object.

AndroidInstanceId

string

The instance ID.

acp-34pqe4r0kd9kn****

TaskId

string

The task ID.

t-bp67acfmxazb4p****

RequestId

string

The request ID.

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

Count

integer

The number of restored instances.

1

TaskId

string

The batch task ID.

t-1ljew7on6ay0j****

Examples

Success response

JSON format

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

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.