All Products
Search
Document Center

Cloud Phone:DescribeBackupFiles

Last Updated:Jun 25, 2026

Mengkueri daftar file backup.

Deskripsi operasi

Saat ini, hanya file backup yang dihasilkan oleh cloud phone yang dapat disimpan di 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

BackupFileId

string

No

ID file backup.

bf-dxrh5jrv0zpb8****

BackupFileName

string

No

Nama file backup. Pencocokan kabur didukung.

abc

InstanceGroupId

string

No

ID kelompok instans.

ag-fxdx91jsfyiy3****

AndroidInstanceId

string

No

ID instans.

acp-34pqe4r0kd9kn****

AndroidInstanceName

string

No

Nama instans. Pencocokan kabur didukung.

acp-34pqe4r0kd9kn****

Description

string

No

Deskripsi. Pencocokan kabur didukung.

desc

StatusList

array

No

Daftar status file backup.

string

No

Status file backup.

Valid values:

  • AVAILABLE :

    可用

  • BACKUPING :

    备份中

  • RECOVERING :

    恢复中

  • DELETING :

    删除中

  • BACKUP_FAILED :

    备份失败

  • RECOVERY_FAILED :

    恢复失败

  • PART_BACKUP_FINISHED :

    部分备份成功

AVAILABLE

StartTime

string

No

Mengkueri file backup yang dibuat setelah pengatur waktu yang ditentukan.

2024-05-23 10:00:00

EndTime

string

No

Mengkueri file backup yang dibuat sebelum pengatur waktu yang ditentukan.

2024-05-20 10:00:00

EndUserId

string

No

Pemilik file backup.

test1

BackupAll

boolean

No

Apakah akan melakukan backup perangkat penuh.

Valid values:

  • true :

    true.

  • false :

    false.

false

MaxResults

integer

No

Jumlah maksimum entri per halaman untuk kueri berhalaman. Nilai valid: 1 hingga 100. Nilai default: 10.

10

NextToken

string

No

Token pagination yang menunjukkan posisi awal pembacaan. Kosongkan parameter ini untuk memulai pembacaan dari awal.

AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uON****

SaleMode

string

No

Elemen respons

Element

Type

Description

Example

object

Parameter tanggapan.

Data

array<object>

Daftar objek hasil yang dikembalikan.

object

Objek hasil yang dikembalikan.

GmtCreated

string

Pengatur waktu pembuatan.

2024-05-15 17:33:59

GmtModified

string

Pengatur waktu modifikasi.

2024-05-15 17:33:59

BackupFileId

string

ID file backup.

bf-b0qbg3pbpjkn7****

BackupFileName

string

Nama file backup.

a-58ftsoo90p0qa****.ab

InstanceGroupId

string

ID instans.

ag-58ftsoo90p0qi****

AndroidInstanceId

string

ID instans.

acp-34pqe4r0kd9kn****

AndroidInstanceName

string

Nama instans.

Test cloud phone

TaskId

string

ID Tugas.

t-bp67acfmxazb4p****

EndUserId

string

Pemilik file backup.

test

Status

string

Status file backup.

Valid values:

  • AVAILABLE :

    Tersedia.

  • RECOVERING :

    Sedang dipulihkan.

AVAILABLE

SourceFilePathList

array

Daftar direktori file backup sumber.

string

Direktori file backup sumber.

/data/media

SourceAppInfoList

array

Daftar nama paket aplikasi yang di-backup.

string

Nama paket aplikasi yang di-backup.

com.example.xhs

RegionId

string

ID wilayah.

cn-hangzhou

FileSize

integer

Ukuran total file backup sumber.

10227168

UploadType

string

Tipe backup.

Valid values:

  • OSS :

    File backup disimpan di bucket OSS.

OSS

UploadEndpoint

string

Nama domain titik akhir unggah.

oss-cn-hangzhou.aliyuncs.com

BackupFilePath

string

Direktori tempat file backup disimpan.

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

Description

string

Deskripsi file backup.

Backup file for /data/media directory.

BackupAll

boolean

Apakah akan melakukan backup perangkat penuh.

false

SystemVersion

string

Channel

string

RequestId

string

ID permintaan. Jika Anda mengalami masalah, berikan ID permintaan ini untuk pemecahan masalah.

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

NextToken

string

Token pagination yang menunjukkan posisi hingga data dibaca dalam panggilan saat ini. Nilai kosong menunjukkan bahwa semua data telah dibaca.

AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uON****

MaxResults

string

Jumlah maksimum entri yang dikembalikan dalam panggilan ini.

10

TotalCount

integer

Jumlah total entri.

91

Contoh

Respons sukses

JSONformat

{
  "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
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.