搜索特定备份文件

在备份文件列表中搜索特定备份文件。

请求 URL

GET {base_url}/{api_path}/backup/search?access_token={access_token}

请求参数

参数 是否必填 类型 说明
page 否 Integer 定义显示第几个页面。
page_size 否 Integer 定义每页显示几项查询结果。
sort_by 否 String 定义排序字段。

取值范围：

  • file_name
  • backup_time
order_by 否 String 定义显示顺序。

取值范围：

  • asc：升序
  • desc：降序
search_value 否 String

定义文件名或备注的关键词，通过此关键词搜索备份文件。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
total_number Integer 匹配此搜索条件的备份文件总数。
backup_list Array<Backup_Info> 备份文件的信息。
Backup_Info
参数 类型 说明
file_name String 备份文件的名称。
backup_time String 备份时间。
memo String 备份文件的备注。

示例

请求示例

从备份文件列表中搜索 18.0.89 版本的备份。

GET /openapi/v1.0/backup/search?access_token=85dEVrxzolca3XhiLZNuxQNUnvEdaapY&search_value=18.0.89 HTTP/1.1
Host: 192.168.5.150:8088

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "total_number": 1,
    "backup_list": [
        {
            "file_name": "Backup-X.18.0.89-20250313132238-local.bak",
            "backup_time": "2025/03/13 13:24:15",
            "memo": ""
        }
    ]
}