全部產品
Search
文件中心

Cloud Phone:BackupFile - 建立備份檔案

更新時間:Sep 29, 2025

產生備份檔案並上傳到遠端儲存。 使用情境:可以基於資料安全的角度進行定期備份,也可以備份一機檔案,恢複到多機,實作類別似複製遷移的效果。

介面說明

目前僅支援雲手機產生的備份檔案儲存在 OSS Object Storage Service服務。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

AndroidInstanceIdList

array

執行個體 ID 列表。

string

執行個體 ID。

aic-ig2bdpk374l12****

Description

string

備份檔案描述。

這是一個備份/data的請求。

SourceFilePathList

array

備份的檔案路徑列表。

string

Android 系統的源檔案目錄絕對路徑。

/data

SourceAppList

array

備份的應用程式套件名列表。

string

備份的應用程式套件名。

com.example.xhs

UploadType

string

備份類型。

枚舉值:

  • OSS :

    備份檔案上傳到 OSS Bucket

OSS

UploadEndpoint

string

備份地址的網域名稱。

說明

如果上傳到 OSS Bucket,調用 describeBuckets 介面擷取 Bucket,如果雲手機和 Bucket 是同地區,擷取 intranetEndpoint 欄位;如果是不同地區擷取 extranetEndpoint 欄位。

oss-cn-shanghai-internal.aliyuncs.com

BackupFilePath

string

備份檔案的上傳地址。

說明

如果上傳到 OSS Bucket,調用 describeBuckets 介面擷取 bucketName,選擇 ossObjectList 擷取 key,key 是 OSS Bucket 的檔案夾路徑,拼接成oss://${bucketName}/${key}

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

BackupFileName

string

備份檔案名稱。

MyBackup

BackupAll

boolean

是否整機備份。

false

ExcludeSourceFilePathList

array

string

返回參數

名稱

類型

描述

樣本值

object

返回參數。

Data

array<object>

返回結果對象。

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

object

BackupFileId

string

備份檔案 ID。

bf-b0qbg3pbpjkn7****

BackupFileName

string

備份檔案名稱。

MyBackup

AndroidInstanceId

string

雲手機執行個體 ID。

acp-34pqe4r0kd9kn****

TaskId

string

任務 ID。

t-22ex666a653gq****

RequestId

string

請求 ID。

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

Count

integer

備份的執行個體個數。

1

TaskId

string

批量任務 ID。

t-14xwibw7pyrjd****

樣本

正常返回樣本

JSON格式

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情