すべてのプロダクト
Search
ドキュメントセンター

:BackupFile

最終更新日:Sep 29, 2025

バックアップファイルを生成し、リモートストレージにアップロードします。この操作は、定期的なデータバックアップに使用できます。また、1 つのインスタンスからファイルをバックアップし、複数のインスタンスに復元することもできます。これは、データのレプリケーションや移行に似たプロセスです。

操作説明

クラウドフォンで生成されたバックアップファイルは、Object Storage Service (OSS) にのみ保存できます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

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 バケットにアップロードします。

OSS

UploadEndpoint

string

任意

アップロード URL のドメイン名。

説明

ファイルを OSS バケットにアップロードする場合は、DescribeBuckets 操作を呼び出してバケット情報を取得します。クラウドフォンとバケットが同じリージョンにある場合は、intranetEndpoint フィールドの値を使用します。異なるリージョンにある場合は、extranetEndpoint フィールドの値を使用します。

oss-cn-shanghai-internal.aliyuncs.com

BackupFilePath

string

必須

バックアップファイルのアップロード URL。

説明

ファイルを OSS バケットにアップロードする場合は、DescribeBuckets 操作を呼び出して bucketName を取得します。次に、ossObjectList からキーを選択します。キーは OSS バケット内のフォルダパスを表します。これらの値を oss://${bucketName}/${key} のフォーマットに結合します。

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

BackupFileName

string

任意

バックアップファイルの名前。

MyBackup

BackupAll

boolean

任意

インスタンス全体をバックアップするかどうかを指定します。

false

レスポンスフィールド

フィールド

説明

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****

成功レスポンス

JSONJSON

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

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。