更新时间:2024-09-04 GMT+08:00

查询可恢复时间段

功能介绍

查询实例的可恢复时间段。

如果您备份策略中的保存天数设置较长,建议您传入查询日期“date”,详见表1

URI

  • URI格式

    GET /v3/{project_id}/instances/{instance_id}/restore-time?date=2020-12-26

  • 参数说明
    表1 参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    String

    参数解释

    租户在某一Region下的项目ID。

    获取方法请参见获取项目ID

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    instance_id

    String

    参数解释

    实例ID。

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

    date

    String

    参数解释

    所需查询的日期,为yyyy-mm-dd字符串格式,时区为UTC。

    约束限制

    不涉及。

    取值范围

    不涉及。

    默认取值

    不涉及。

请求消息

  • 请求参数

    无。

  • URI样例
    • 查询实例的所有可恢复时间段
      GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/restore-time
    • 根据指定日期查询实例的可恢复时间段
      GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/restore-time?date=2020-12-26

响应消息

  • 正常响应要素说明
    表2 要素说明

    名称

    参数类型

    说明

    restore_time

    Array of objects

    参数解释

    可恢复时间段列表。详情请参见表3

    表3 restore_time字段数据结构说明

    名称

    参数类型

    说明

    start_time

    Integer

    参数解释

    可恢复时间段的起始时间点,UNIX时间戳格式,单位是毫秒,时区是UTC。

    取值范围

    不涉及。

    end_time

    Integer

    参数解释

    可恢复时间段的结束时间点,UNIX时间戳格式,单位是毫秒,时区是UTC。

    取值范围

    不涉及。

  • 正常响应样例
    { 
    	"restore_time": [ 
    		{ 
    			"start_time": 1532001446987, 
    			"end_time": 1532742139000 
    		} 
    	] 
    }
  • 异常响应

    请参见异常请求结果

状态码