文档

DescribeBackupFiles - 查询备份文件列表

更新时间:

调用DescribeBackupFiles接口查询备份文件列表。

接口说明

目前仅支持云手机生成的备份文件保存在 OSS 对象存储服务。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
BackupFileIdstring

备份文件 ID。

bf-dxrh5jrv0zpb8****
BackupFileNamestring

备份文件名称模糊查询。

测试
InstanceGroupIdstring

实例组 ID。

ag-fxdx91jsfyiy3****
AndroidInstanceIdstring

实例 ID。

acp-34pqe4r0kd9kn****
AndroidInstanceNamestring

实例名称模糊查询。

acp-34pqe4r0kd9kn****
Descriptionstring

描述模糊查询。

测试
StartTimestring

查询当前时间之后的备份文件。

2024-05-23 10:00:00
EndTimestring

查询当前时间之前的备份文件。

2024-05-20 10:00:00
EndUserIdstring

备份文件的 Owner。

test1
MaxResultslong

分页查询时每页的最大条目数。取值范围 1~100,默认值为 10。

10
NextTokenstring

用来表示当前开始读取的位置。置空表示从头开始。

AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uON****

返回参数

名称类型描述示例值
object

返回参数。

Dataobject []

返回结果对象列表。

GmtCreatedstring

创建时间。

2024-05-15 17:33:59
GmtModifiedstring

更新时间

2024-05-15 17:33:59
BackupFileIdstring

备份文件 ID。

bf-b0qbg3pbpjkn7****
BackupFileNamestring

备份文件名称。

a-58ftsoo90p0qa****.ab
InstanceGroupIdstring

实例 ID。

ag-58ftsoo90p0qi****
AndroidInstanceIdstring

实例 ID。

acp-34pqe4r0kd9kn****
AndroidInstanceNamestring

实例名称。

测试云手机
EndUserIdstring

备份文件的 Owner。

test
Statusstring

备份文件状态。

枚举值:
  • AVAILABLE可用
  • RECOVERING恢复中
AVAILABLE
SourceFilePathListarray

源备份文件的目录列表。

string

源备份文件的目录。

/data/media
FileSizelong

源备份文件总大小。

10227168
UploadTypestring

备份类型。

枚举值:
  • OSS备份文件保存在OSS桶。
OSS
UploadEndpointstring

上传地址的域名。

oss-cn-hangzhou.aliyuncs.com
BackupFilePathstring

备份文件保存的目录。

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

备份文件的描述信息。

这是备份/data/media目录的备份文件。
RequestIdstring

请求唯一 ID,如果遇到问题请提供这个请求 ID,由工作人员为您排查。

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

用来表示当前调用返回读取到的位置。空代表数据已经读取完毕。

AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uON****
MaxResultsstring

本次读取的最大数据量。

10
TotalCountlong

总条目数。

91

示例

正常返回示例

JSON格式

{
  "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": "测试云手机",
      "EndUserId": "test",
      "Status": "AVAILABLE",
      "SourceFilePathList": [
        "/data/media"
      ],
      "FileSize": 10227168,
      "UploadType": "OSS",
      "UploadEndpoint": "oss-cn-hangzhou.aliyuncs.com",
      "BackupFilePath": "oss://cloudphone-saved-bucket-cn-shanghai/backup/aic-58ftsoo90p0qa****.ab",
      "Description": "这是备份/data/media目录的备份文件。"
    }
  ],
  "RequestId": "425F351C-3F8E-5218-A520-B6311D0D****",
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6l5V9uON****",
  "MaxResults": "10",
  "TotalCount": 91
}

错误码

访问错误中心查看更多错误码。

  • 本页导读