功能介绍

恢复到当前实例。

调试

您可以在API Explorer中调试该接口。

URI

• URI格式

  POST https://{Endpoint}/v3/{project_id}/instances/recovery

• URI样例

  https://dds.cn-north-1.myhuaweicloud.com/v3/056538411200d4cd2f79c003c7606412/instances/recovery

• 参数说明

  表1 参数说明

  名称	是否必选	描述
  project_id	是	租户在某一Region下的Project ID。

请求消息

• 参数说明

  表2 参数说明

  名称	是否必选	参数类型	描述
  source	是	Object	恢复数据源对象。 请参见表3。
  target	是	Object	恢复目标对象。 请参见表4。

  表3 source字段数据结构说明

  名称	是否必选	参数类型	描述
  instance_id	是	String	实例ID，可以调用“查询实例列表”接口获取。如果未申请实例，可以调用“创建实例”接口创建。
  type	否	String	表示恢复方式，枚举值： “backup”，表示使用备份文件恢复，按照此方式恢复时，“type”字段为非必选，“backup_id”必选。 “timestamp”，表示按时间点恢复，按照此方式恢复时，“type”字段必选，“restore_time”必选。
  backup_id	否	String	用于恢复的备份ID。当使用备份文件恢复时需要指定该参数。
  restore_time	否	String	恢复数据的时间点，格式为UNIX时间戳，单位是毫秒，时区为UTC。 说明： 目前该参数只适用于副本集实例。

  表4 target字段数据结构说明

  名称	是否必选	参数类型	描述
  instance_id	是	String	恢复目标实例ID，可以调用“查询实例列表”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

• 请求体样例
  • 使用备份文件恢复

    {
      "source": {
        "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin02",
        "type": "backup",
        "backup_id": "2f4ddb93-b901-4b08-93d8-1d2e472f30fe"
      },
      "target": {
        "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin02"
      }
    }

  • 根据时间点恢复（适用于副本集实例和4.0版本的集群实例）

    {
      "source": {
        "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin02",
        "type": "timestamp",
        "restore_time": 1532001446987
      },
      "target": {
        "instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin02"
      }
    }

响应消息

• 要素说明

  表5 要素说明

  名称	参数类型	描述
  job_id	String	恢复操作的异步任务ID。

• 响应样例

  {
      "job_id": "a03b1b8a-b756-467c-8a49-38720c3d23ec"
  }

状态码

详情请参见状态码。

错误码

详情请参见错误码。