更新时间:2022-05-09 GMT+08:00
分享

查询实例备份信息

功能介绍

查询指定缓存实例的备份信息列表。

调试

您可以在API Explorer中调试该接口,并获取该接口关联的CLI示例: hcloud DCS ListBackupRecords

URI

GET /v2/{project_id}/instances/{instance_id}/backups

表1 路径参数

参数

是否必选

参数类型

描述

instance_id

String

实例ID。

project_id

String

项目ID。

表2 Query参数

参数

是否必选

参数类型

描述

begin_time

String

查询开始时间,时间为UTC时间。格式:yyyyMMddHHmmss,如:20170718235959。

end_time

String

查询结束时间,时间为UTC时间。格式:yyyyMMddHHmmss,如:20170718235959。

limit

Integer

每页显示的条目数量。

offset

Integer

偏移量,表示从此偏移量开始查询, offset大于等于0。

请求参数

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

total_num

Integer

返回记录数。

backup_record_response

Array of BackupRecordResponse objects

备份信息的详情数组。

表4 BackupRecordResponse

参数

参数类型

描述

backup_id

String

备份记录ID。

period

String

备份执行时间段。

backup_name

String

备份记录名称。

instance_id

String

实例ID。

size

Long

备份文件大小(Byte)。

backup_type

String

备份类型。

  • manual:表示备份类型为手动备份

  • auto:表示备份类型为自动备份

枚举值:

  • manual

  • auto

created_at

String

备份任务创建时间。

updated_at

String

备份完成时间。

progress

String

备份进度。

error_code

String

备份失败后错误码

  • dcs.08.0001 - 启动备份恢复工具失败。

  • dcs.08.0002 - 执行超时。

  • dcs.08.0003 - 删除桶失败。

  • dcs.08.0004 - 获取ak/sk 失败。

  • dcs.08.0005 - 创建桶失败。

  • dcs.08.0006 - 查询备份数据大小失败。

  • dcs.08.0007 - 恢复时同步数据失败。

  • dcs.08.0008 - 自动备份任务未运行,实例正在运行其他任务。

remark

String

备份缓存实例的备注信息。

status

String

备份状态。

  • waiting:等待中。

  • backuping:备份中。

  • succeed:备份成功。

  • failed:备份失败。

  • expired:备份文件过期。

  • deleted:已手动删除备份文件。

枚举值:

  • waiting

  • backuping

  • succeed

  • failed

  • expired

  • deleted

is_support_restore

String

是否可以进行恢复操作,取值为TRUE或FALSE。

状态码: 400

表5 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息

最大长度:1024

error_code

String

错误码

最大长度:9

error_ext_msg

String

扩展错误信息(暂未使用,赋值为null)

最大长度:1024

状态码: 500

表6 响应Body参数

参数

参数类型

描述

error_msg

String

错误信息

最大长度:1024

error_code

String

错误码

最大长度:9

error_ext_msg

String

扩展错误信息(暂未使用,赋值为null)

最大长度:1024

请求示例

GET https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/backups?offset={offset}&limit={limit}&beginTime={begin_Time}&end_time={end_Time}

响应示例

状态码: 200

查询缓存实例备份信息成功。

{
  "total_num" : 1,
  "backup_record_response" : [ {
    "period" : { },
    "backup_type" : "manual",
    "created_at" : "2019-05-10T08:31:16.166Z",
    "execution_at" : "2019-05-10T08:31:21.461Z",
    "remark" : "001",
    "is_support_restore" : "TRUE",
    "backup_id" : "4631832a-14c6-45b0-a0b3-3abd8f591ad1",
    "backup_name" : "backup_20190510163116",
    "instance_id" : "5560df16-cebf-4473-95c4-d1b573c16e79",
    "size" : 880232,
    "updated_at" : "2019-05-10T08:32:30.546Z",
    "progress" : "100.00",
    "error_code" : { },
    "status" : "succeed"
  } ]
}

状态码

状态码

描述

200

查询缓存实例备份信息成功。

400

非法请求。

500

内部服务错误。

错误码

请参见错误码

分享:

    相关文档

    相关产品

关闭导读