全部产品
Search
文档中心

Cloud Phone:BackupFile

更新时间:Dec 21, 2025

Menghasilkan file backup dan mengunggahnya ke penyimpanan remote. Operasi ini dapat digunakan untuk mencadangkan data secara berkala, serta untuk mencadangkan file dari satu instans dan memulihkannya ke beberapa instans—proses yang mirip dengan replikasi atau migrasi data.

Deskripsi operasi

File backup yang dihasilkan oleh cloud phone hanya dapat disimpan ke 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

ID instans.

aic-ig2bdpk374l12****

Description

string

No

Deskripsi file backup.

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

SourceFilePathList

array

No

Daftar jalur file yang akan dibackup.

string

No

Jalur mutlak folder sumber dalam sistem Android.

/data

SourceAppList

array

No

Daftar nama paket aplikasi yang akan dibackup.

string

No

Nama paket aplikasi yang akan dibackup.

com.example.xhs

UploadType

string

No

Tipe backup.

Valid values:

  • OSS :

    Mengunggah file backup 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 tersebut. Jika cloud phone dan bucket berada di wilayah yang sama, gunakan nilai bidang intranetEndpoint. Jika berada di wilayah berbeda, gunakan nilai bidang extranetEndpoint.

oss-cn-shanghai-internal.aliyuncs.com

BackupFilePath

string

Yes

URL unggah untuk file backup.

Catatan

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

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

BackupFileName

string

No

Nama file backup.

MyBackup

BackupAll

boolean

No

Menentukan apakah seluruh instans akan dibackup.

false

ExcludeSourceFilePathList

array

No

string

No

Elemen respons

Element

Type

Description

Example

object

Parameter respons.

Data

array<object>

Objek hasil.

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

object

BackupFileId

string

ID file backup.

bf-b0qbg3pbpjkn7****

BackupFileName

string

Nama file backup.

MyBackup

AndroidInstanceId

string

ID instans cloud phone.

acp-34pqe4r0kd9kn****

TaskId

string

ID task.

t-22ex666a653gq****

RequestId

string

ID permintaan.

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

Count

integer

Jumlah instans yang dibackup.

1

TaskId

string

ID task batch.

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.