You need to enable JavaScript to run this app.
导航
云数据库 MySQL 版
  • 文档首页
    • /
  • 云数据库 MySQL 版

RecoveryDBInstance

最近更新时间：2023.09.05 21:27:31

首次发布时间：2021.11.29 18:44:25

我的收藏

调用 RecoveryDBInstance 接口恢复一个 MySQL 备份到新实例。

请求类型

异步请求。

请求参数

名称类型是否必选示例值描述

InstanceId

String

是

rds-mysql-h441603c68aaa****

被恢复的实例 ID。

说明

您可以调用 ListDBInstances 接口查询实例信息，包括实例 ID。

RecoveryTypeString否Instance恢复类型。取值为 Instance ，即实例恢复。
BackupIdString否990e1fa0df8b4aadb45f00ad00ab****备份 ID， 与参数 RestoreTime 二选一。
RestoreTimeString否2020-01-01 00:00:00恢复的时间，格式： yyyy-MM-dd HH:mm:ss （ UTC 时间），与参数 BackupId 二选一。

InstanceName

String

否

test1

被恢复的实例名称。

说明

您可以调用 ListDBInstances 接口查询实例信息，包括实例名称。

InstanceSpecName

String

否

rds.mysql.2c4g

实例规格名称，您可指定要实例的规格名称，取值：

  • rds.mysql.1c2g
  • rds.mysql.2c4g
  • rds.mysql.2c8g
  • rds.mysql.2c16g
  • rds.mysql.4c8g
  • rds.mysql.4c16g
  • rds.mysql.4c32g
  • rds.mysql.8c16g
  • rds.mysql.8c32g
  • rds.mysql.8c64g
  • rds.mysql.16c32g
  • rds.mysql.16c64g
  • rds.mysql.16c96g
  • rds.mysql.16c128g
  • rds.mysql.32c64g
  • rds.mysql.32c128g
  • rds.mysql.32c256g
  • rds.mysql.64c128g
  • rds.mysql.64c256g
  • rds.mysql.64c512g
  • rds.mysql.88c720g
  • rds.mysql.108c864g

    说明

    若不指定实例规格，则与原实例相同。

    • StorageTypeString否LocalSSD实例存储类型，必须与原实例相同。取值：
    LocalSSD：本地 SSD 盘。

    StorageSpaceGB

    Integer

    否

    100

    实例存储空间。取值范围：20~3000，单位为 GB；且不小于已用空间的 120%。

    说明

    若不指定则与原实例相同。

    VpcID

    String

    否

    vpc-3ajzohyfaru9s340jz1rp****

    私有网络（VPC）ID。

    说明

    您可以调用 ListVpcs 接口查询要创建实例的 VPC ID。

    ChargeTypeString是PostPaid付费类型。取值：
  • PostPaid：后付费（按量计费）。
  • Prepaid：预付费（包年包月）。

    • AutoRenew

    Boolean

    否

    true

    是否自动续费。取值：

  • true：是。
  • false：否。

    说明

    若 ChargeType 设置了预付费（即 Prepaid），该参数必填。

    • PrepaidPeriod

    String

    否

    Month

    购买周期。取值：

  • Month ：包月。
  • Year ：包年。

    说明

    若 ChargeType 设置了预付费（即 Prepaid），该参数必填。

    • UsedTime

    Integer

    否

    1

    购买时长。

    说明

    若 ChargeType 设置了预付费（即 Prepaid），该参数必填。

    返回参数

    名称类型是否必选示例值描述
    InstanceIdString是rds-mysql-h0cad119b9b25****新实例 ID。

    请求示例

    POST /?Action=RecoveryDBInstance&Version=2018-01-01 HTTP/1.1
Content-Type: application/json
Host: rds.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request, SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645a****

{
    "InstanceId" : "rds-mysql-h441603c68aaa****",
    "RecoverType" : "Instance",
    "RestoreTime" : "2020-01-01 00:00:00",
    "InstanceName" : "test1",
    "InstanceSpecName" : "rds.mysql.2c4g",
    "StorageType" : "LocalSSD"
    "StorageSpaceGB" : "100",
    "VpcID" : "vpc-3ajzohyfaru9s340jz1rp****",
    "RestoreTime" : "2020-01-01 00:00:00",
    "ChargeType" : "PostPaid"
}

    返回示例

    正常返回示例

    {
    "ResponseMetadata" : {
        "RequestId": "d78bbf4e-63a5-4937-ac3c-3767e7eddfbe",
        "Action": "RecoveryDBInstance",
        "Version": "2018-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
      "Result": {
        "InstanceId" : "rds-mysql-h0cad119b9b25****"
    }
}

    错误码

    更多详情，请参见错误码。