全部产品
Search
文档中心

云数据库 RDS:RecoveryDBInstance - 恢复备份到新实例

更新时间:Mar 19, 2024

该接口用于将RDS SQL Server备份数据恢复到新实例上。

接口说明

适用引擎

RDS SQL Server(2012 及以上版本的实例)

相关功能文档

注意 使用该接口前,请仔细阅读功能文档,确保完全了解使用接口的前提条件及使用后造成的影响后,再进行操作。
恢复 SQL Server 数据

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
rds:RecoveryDBInstanceWrite
  • DBInstance
    acs:rds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}
  • rds:ResourceTag

请求参数

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

新实例规格。详情请参见实例规格

mssql.x4.medium.s1
DBInstanceStorageinteger

新实例存储容量。单位:GB。详情请参见实例规格

说明 新实例的磁盘空间不能小于原实例的磁盘空间。
40
PayTypestring

新实例付费类型:

  • Postpaid:后付费(按量付费)
  • Prepaid:预付费(包年包月)
Postpaid
InstanceNetworkTypestring

新实例网络类型:

  • Classic:经典网络
  • VPC:专有网络

默认与原实例网络类型一致。

VPC
DBInstanceIdstring

原实例 ID。

说明
  • 按备份集恢复(即指定 BackupId 参数)时,本参数不是必须项。
  • 按时间点恢复(即指定 RestoreTime 参数)时,本参数为必须项。
  • rm-bp18****
    TargetDBInstanceIdstring

    目标实例 ID。

    rm-bp17****
    DbNamesstring

    数据库名称,恢复数据至新实例时格式为:原库名 1,新库名 2

    说明 如需恢复到已有实例,请参见 CopyDatabaseBetweenInstances
    test1,test2
    BackupIdstring

    备份集 ID,可通过查询备份列表接口 DescribeBackups 获取。

    指定此参数时,DBInstanceId 参数为可选。

    说明 BackupIdRestoreTime 两者至少传入一个。
    29304****
    RestoreTimestring

    备份保留周期内的任意时间点。格式:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

    指定此参数时,DBInstanceId 参数为必须。

    说明 BackupIdRestoreTime 两者至少传入一个。
    2011-06-11T16:00:00Z
    VPCIdstring

    新实例专有网络 VPC ID。

    vpc-****
    VSwitchIdstring

    新实例虚拟交换机 ID,多个值用半角逗号(,)隔开。

    vsw-****
    PrivateIpAddressstring

    设置新实例的内网 IP,需要在指定交换机的 IP 地址范围内。系统默认通过 VPCIdVSwitchId 自动分配。

    172.XX.XX.69
    UsedTimestring

    指定新实例购买时长,取值:

    • 当参数 PeriodYear 时,UsedTime 取值为1~3
    • 当参数 PeriodMonth 时,UsedTime 取值为1~9
    说明 若付费类型为 Prepaid 则该参数必须传入。
    1
    Periodstring

    指定新的预付费实例为包年或者包月类型,取值:

    • Year:包年
    • Month:包月
    说明 若参数 PayType=Prepaid,该参数必须传入。
    Month
    DBInstanceStorageTypestring

    新实例存储类型,取值:

    • local_ssd/ephemeral_ssd:本地 SSD 盘
    • cloud_ssd:SSD 云盘
    • cloud_essd:ESSD 云盘
    cloud_essd

    返回参数

    名称类型描述示例值
    object

    返回参数详情。

    DBInstanceIdstring

    实例 ID。

    rm-bp1v****
    RequestIdstring

    请求 ID。

    E4CDD460-2618-51FE-BD0B-A1****
    OrderIdstring

    订单 ID。

    2270972****

    示例

    正常返回示例

    JSON格式

    {
      "DBInstanceId": "rm-bp1v****",
      "RequestId": "E4CDD460-2618-51FE-BD0B-A1****",
      "OrderId": "2270972****"
    }

    错误码

    HTTP status code错误码错误信息描述
    400IllegalParameterillegal parameter, param is empty.参数不正确。
    400InvalidRecoveryDbInstance.StorageSizeThe disk space of the new instance cannot be less than that of the current instance操作失败,新实例的磁盘空间不能小于当前实例的空间。
    400DBCountLimitExceededDb count limit exceeded.超过了数据库计数限制。
    400Order.ComboInstanceNotAllowOperateA package instance is not allowed to operate independently.套餐实例不允许单独操作。
    400Price.PricingPlanResultNotFoundPricing plan price result not found.定价计划价格结果没有找到。
    400Order.NoRealNameAuthenticationYou have not passed the real-name authentication and do not meet the purchase conditions. Please log in to the user center for real-name authentication.您还未通过实名认证,不符合购买条件,请登录用户中心进行实名认证。
    400InsufficientAvailableQuotaYour account quota limit is less than 0, please recharge before trying to purchase.您的账户可用额度小于0,请先充值后再尝试购买。
    403Forbidden.SnapshotRecoverySnapshot backup does not support partial restore操作失败,快照备份不支持部分还原。
    403StorageLimitExceededExceeding the allowed Storage of DB instance已超过磁盘空间限制,请清理磁盘空间。

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

    变更历史

    变更时间变更内容概要操作
    2023-09-08OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      错误码 403 变更
      删除错误码:400
    2023-06-09OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403