すべてのプロダクト
Search

このプロダクト

    :DescribeBackupFiles

    ドキュメントセンター

    :DescribeBackupFiles

    最終更新日:Jun 25, 2026

    バックアップファイルのリストを照会します。

    操作説明

    現在、クラウドフォンによって生成されたバックアップファイルのみが Object Storage サービス (OSS) に保存できます。

    今すぐお試しください

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

    テスト

    RAM 認証

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

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    BackupFileId

    string

    任意

    バックアップファイル ID。

    bf-dxrh5jrv0zpb8****
    BackupFileName

    string

    任意

    バックアップファイル名。あいまい一致がサポートされています。

    abc
    InstanceGroupId

    string

    任意

    インスタンスグループ ID。

    ag-fxdx91jsfyiy3****
    AndroidInstanceId

    string

    任意

    インスタンス ID。

    acp-34pqe4r0kd9kn****
    AndroidInstanceName

    string

    任意

    インスタンス名。あいまい一致がサポートされています。

    acp-34pqe4r0kd9kn****
    Description

    string

    任意

    説明。あいまい一致がサポートされています。

    desc
    StatusList

    array

    任意

    バックアップファイルステータスのリスト。

    string

    任意

    バックアップファイルのステータス。

    列挙値:

    • AVAILABLE :

      可用

    • BACKUPING :

      备份中

    • RECOVERING :

      恢复中

    • DELETING :

      删除中

    • BACKUP_FAILED :

      备份失败

    • RECOVERY_FAILED :

      恢复失败

    • PART_BACKUP_FINISHED :

      部分备份成功

    AVAILABLE
    StartTime

    string

    任意

    指定された時間以降に作成されたバックアップファイルを照会します。

    2024-05-23 10:00:00
    EndTime

    string

    任意

    指定された時間以前に作成されたバックアップファイルを照会します。

    2024-05-20 10:00:00
    EndUserId

    string

    任意

    バックアップファイルのオーナー。

    test1
    BackupAll

    boolean

    任意

    デバイスの完全バックアップを実行するかどうかを指定します。

    列挙値:

    • true :

      true。

    • false :

      false。

    false
    MaxResults

    integer

    任意

    ページングクエリの 1 ページあたりのエントリの最大値。有効な値: 1～100。デフォルト値: 10。

    10
    NextToken

    string

    任意

    読み取りを開始する位置を示すページネーショントークン。最初から読み取りを開始するには、このパラメーターを空のままにします。

    AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uON****
    SaleMode

    string

    任意

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答パラメーター。

    Data

    array<object>

    返された結果オブジェクトのリスト。

    object

    返された結果オブジェクト。

    GmtCreated

    string

    作成時間。

    2024-05-15 17:33:59
    GmtModified

    string

    変更時間。

    2024-05-15 17:33:59
    BackupFileId

    string

    バックアップファイル ID。

    bf-b0qbg3pbpjkn7****
    BackupFileName

    string

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

    a-58ftsoo90p0qa****.ab
    InstanceGroupId

    string

    インスタンス ID。

    ag-58ftsoo90p0qi****
    AndroidInstanceId

    string

    インスタンス ID。

    acp-34pqe4r0kd9kn****
    AndroidInstanceName

    string

    インスタンス名。

    Test cloud phone
    TaskId

    string

    タスク ID。

    t-bp67acfmxazb4p****
    EndUserId

    string

    バックアップファイルのオーナー。

    test
    Status

    string

    バックアップファイルのステータス。

    列挙値:

    • AVAILABLE :

      利用可能。

    • RECOVERING :

      リカバリ中。

    AVAILABLE
    SourceFilePathList

    array

    ソースバックアップファイルディレクトリのリスト。

    string

    ソースバックアップファイルディレクトリ。

    /data/media
    SourceAppInfoList

    array

    バックアップされたアプリケーションパッケージ名のリスト。

    string

    バックアップされたアプリケーションパッケージ名。

    com.example.xhs
    RegionId

    string

    リージョン ID。

    cn-hangzhou
    FileSize

    integer

    ソースバックアップファイルの合計サイズ。

    10227168
    UploadType

    string

    バックアップタイプ。

    列挙値:

    • OSS :

      バックアップファイルは OSS バケットに保存されます。

    OSS
    UploadEndpoint

    string

    アップロードエンドポイントのドメイン名。

    oss-cn-hangzhou.aliyuncs.com
    BackupFilePath

    string

    バックアップファイルが保存されるディレクトリ。

    oss://cloudphone-saved-bucket-cn-shanghai/backup/aic-58ftsoo90p0qa****.ab
    Description

    string

    バックアップファイルの説明。

    Backup file for /data/media directory.
    BackupAll

    boolean

    デバイスの完全バックアップを実行するかどうかを指定します。

    false
    SystemVersion

    string

    Channel

    string

    RequestId

    string

    リクエスト ID。問題が発行された場合、トラブルシューティングのためにこのリクエスト ID を提供してください。

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

    string

    現在の呼び出しでデータが読み取りされた位置を示すページネーショントークン。空の値はすべてのデータが読み取りされたことを示します。

    AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uON****
    MaxResults

    string

    この呼び出しで返されたエントリの最大値。

    10
    TotalCount

    integer

    エントリの総数。

    91

    例

    成功レスポンス

    JSONJSON

    {
  "Data": [
    {
      "GmtCreated": "2024-05-15 17:33:59",
      "GmtModified": "2024-05-15 17:33:59",
      "BackupFileId": "bf-b0qbg3pbpjkn7****",
      "BackupFileName": "a-58ftsoo90p0qa****.ab",
      "InstanceGroupId": "ag-58ftsoo90p0qi****",
      "AndroidInstanceId": "acp-34pqe4r0kd9kn****",
      "AndroidInstanceName": "Test cloud phone",
      "TaskId": "t-bp67acfmxazb4p****",
      "EndUserId": "test",
      "Status": "AVAILABLE",
      "SourceFilePathList": [
        "/data/media"
      ],
      "SourceAppInfoList": [
        "com.example.xhs"
      ],
      "RegionId": "cn-hangzhou",
      "FileSize": 10227168,
      "UploadType": "OSS",
      "UploadEndpoint": "oss-cn-hangzhou.aliyuncs.com",
      "BackupFilePath": "oss://cloudphone-saved-bucket-cn-shanghai/backup/aic-58ftsoo90p0qa****.ab",
      "Description": "Backup file for /data/media directory.",
      "BackupAll": false,
      "SystemVersion": "",
      "Channel": ""
    }
  ],
  "RequestId": "425F351C-3F8E-5218-A520-B6311D0D****",
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uON****",
  "MaxResults": "10",
  "TotalCount": 91
}

    エラーコード

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

    変更履歴

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