All Products
Search
Document Center

Cloud Phone:BackupFile

Last Updated:Jun 10, 2026

Membuat file cadangan dan mengunggahnya ke penyimpanan jarak jauh. Anda dapat menggunakan operasi ini untuk pencadangan data rutin. Anda juga dapat mencadangkan file dari satu instans dan memulihkannya ke beberapa instans, proses yang mirip dengan replikasi atau migrasi data.

Deskripsi operasi

You can save backup files generated by cloud phones only to Object Storage Service (OSS).

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

AndroidInstanceIdList

array

Yes

Daftar ID instans.

string

No

The instance ID.

aic-ig2bdpk374l12****

Description

string

No

Deskripsi file cadangan.

这是一个备份/data的请求。

SourceFilePathList

array

No

Daftar jalur file yang akan dicadangkan.

string

No

The absolute path of the source folder in the Android system.

/data

SourceAppList

array

No

Daftar nama paket aplikasi yang akan dicadangkan.

string

No

The application package name to back up.

com.example.xhs

UploadType

string

No

Tipe pencadangan.

Valid values:

  • OSS :

    Mengunggah file cadangan ke bucket OSS.

OSS

UploadEndpoint

string

No

Nama domain URL unggah.

Catatan

Jika Anda mengunggah file ke bucket OSS, panggil operasi DescribeBuckets untuk mendapatkan informasi bucket. Jika cloud phone dan bucket berada di wilayah yang sama, gunakan nilai bidang intranetEndpoint. Jika berada di wilayah yang berbeda, gunakan nilai bidang extranetEndpoint.

oss-cn-shanghai-internal.aliyuncs.com

BackupFilePath

string

Yes

URL unggah untuk file cadangan.

Catatan

Jika Anda mengunggah file ke bucket OSS, panggil operasi DescribeBuckets untuk mendapatkan bucketName. Lalu, pilih kunci dari ossObjectList. Kunci tersebut mewakili jalur folder di bucket OSS. Gabungkan nilai-nilai ini ke dalam format oss://${bucketName}/${key}.

oss://cloudphone-saved-bucket-****/backupDir/

BackupFileName

string

No

Nama file cadangan.

MyBackup

BackupAll

boolean

No

Apakah akan mencadangkan seluruh instans.

false

ExcludeSourceFilePathList

array

No

string

No

Elemen respons

Element

Type

Description

Example

object

The response parameters.

Data

array<object>

The result object.

6C8439B9-7DBF-57F4-92AE-55A9B9D3****

object

BackupFileId

string

The ID of the backup file.

bf-b0qbg3pbpjkn7****

BackupFileName

string

The name of the backup file.

MyBackup

AndroidInstanceId

string

The ID of the cloud phone instance.

acp-34pqe4r0kd9kn****

TaskId

string

The task ID.

t-22ex666a653gq****

RequestId

string

The request ID.

6C8439B9-7DBF-57F4-92AE-55A9B9D3****

Count

integer

The number of instances that are backed up.

1

TaskId

string

The batch task ID.

t-14xwibw7pyrjd****

Contoh

Respons sukses

JSONformat

{
  "Data": [
    {
      "BackupFileId": "bf-b0qbg3pbpjkn7****",
      "BackupFileName": "MyBackup",
      "AndroidInstanceId": "acp-34pqe4r0kd9kn****",
      "TaskId": "t-22ex666a653gq****"
    }
  ],
  "RequestId": "6C8439B9-7DBF-57F4-92AE-55A9B9D3****",
  "Count": 1,
  "TaskId": "t-14xwibw7pyrjd****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.