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

RestoreToNewInstance

最近更新时间：2023.11.14 14:16:24

首次发布时间：2023.07.26 13:58:16

我的收藏

调用 RestoreToNewInstance 接口将已有实例的备份数据恢复至一个新的实例中。

请求类型

异步请求。

请求参数

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

SrcInstanceId

String

是

vedbm-h441603c68aaa****

备份文件所属原实例的 ID。

说明

您可以调用 DescribeDBInstances 接口查询实例 ID。

BackupId

String

否

snap-64b7****-5935

原实例的备份文件 ID，使用该备份文件中保存的数据创建新实例。

说明

  • 该参数与 RestoreTime 参数二者必须选择其一。
  • 您可以调用 DescribeBackups 查询指定实例的备份文件列表信息。

RestoreTime

String

否

2023-07-14T15:47:10Z

原实例日志备份保留时间内的任意时间点，格式为 yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。

说明

  • 该参数与 BackupId 参数二者必须选择其一。
  • 您可以调用 DescribeRecoverableTime 查询指定实例可恢复的时间范围。

ZoneIds

String

是

cn-beijing-a

可用区 ID。

说明

您可以调用 DescribeAvailabilityZones 接口查询 veDB MySQL 实例支持的可用区资源。

NodeSpecString是vedb.mysql.x4.large实例的规格代码。详细信息，请参见产品规格。
NodeNumberInteger是2实例的节点数量。取值范围为 2~16 个。

VpcId

String

是

vpc-3ajzohyfaru9s340jz1rp****

私有网络（VPC） ID。

说明

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

SubnetId

String

是

subnet-1g15j13jtzgu88ibuxwqp****

子网 ID。子网必须属于所选的可用区。

说明

  • 子网是私有网络内的 IP 地址块，私有网络中的所有云资源都必须部署在子网内，子网为云资源分配私网 IP 地址。
  • 您可以调用 CreateSubnet 接口创建子网，调用 DescribeSubnets 接口查询指定可用区内的所有子网列表信息，包括子网 ID。

ChargeType

String

是

PostPaid

付费类型，取值：

  • PostPaid：按量计费（后付费）。
  • PrePaid：包年包月（预付费）。

InstanceName

String

否

Name123

实例名称。命名规则：

  • 不能以数字、中划线（-）开头。
  • 只能包含中文、字母、数字、下划线（_）和中划线（-）。
  • 长度需在 1~128 个字符内。
ProjectNameString否default实例所属的项目名称，当该参数留空时，新建的实例默认加入 default 项目。

Tags

Array of TagObject

否

请参见请求示例。

需要绑定的标签键和标签值数组对象。关于 Tags 的更多详情，请参见 TagObject。

说明

  • 支持一次传入多组标签键值对象，多组标签键值对象间用英文逗号（,）分隔。单次最多同时传入 20 组标签键值对，单个实例最多绑定 50 个标签。
  • 标签键值需满足设置规则，具体规则请参见标签设置规则。

AutoRenew

Boolean

否

false

预付费场景下是否自动续费。取值：

  • true：自动续费。
  • fasle：不自动续费。

说明

当 ChargeType（计费类型） 取值为 PrePaid（包年包月） 时，该参数必填。

PeriodUnit

String

否

Month

预付费场景下的购买周期。

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

说明

当 ChargeType（计费类型） 取值为 PrePaid（包年包月） 时，该参数必填。

Period

Integer

否

1

预付费场景下的购买时长。

说明

当 ChargeType（计费类型） 取值为 PrePaid（包年包月） 时，该参数必填。

PrePaidStorageInGB

Integer

否

50

预付费场景下的存储空间大小，

说明

当 ChargeType（计费类型） 取值为 PrePaid（包年包月） 时，该参数必填。

返回参数

名称类型示例值描述
InstanceIdStringvedbm-h441603c68aaa****实例 ID。
OrderIdStringOrder707643373078888****订单 ID。

请求示例

  • 按备份集恢复

    POST /?Action=RestoreToNewInstance&Version=2022-01-01 HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: vedbm.volcengineapi.com
X-Date: 20220614T114308Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20220614/cn-beijing/vedbm/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****

{
        "ZoneIds": "cn-beijing-b",
        "NodeSpec": "vedb.mysql.x4.large",
        "NodeNumber": 2,
        "SrcInstanceId": "vedbm-gzwdsf9b****",
        "VpcId": "vpc-13fz0iip9nlds3n6nu4fi****",
        "SubnetId": "subnet-13fz1bsbrsw743n6nu47c****",
        "ProjectName": "default",
        "ChargeType": "PostPaid",
        "BackupId": "snap-64b7****-5935",
        "Tags": [{
            "Key": "chargetype",
            "Value": "prepaid"
        }],
        "InstanceName": "Name123"
}

  • 按时间点恢复

    POST /?Action=RestoreToNewInstance&Version=2022-01-01 HTTP/1.1
Accept: application/json
Content-Type: application/json
Host: vedbm.volcengineapi.com
X-Date: 20220614T114308Z
Authorization: HMAC-SHA256 Credential=AKIAIAGMBG4SXSQQ****/20220614/cn-beijing/veDB/request, SignedHeaders=accept;content-type;host;x-date, Signature=6a593bf5f59e7c1109fb205c739d1cff4c672fe2d251963f4d48c8701d16****

{
        "ZoneIds": "cn-beijing-b",
        "NodeSpec": "vedb.mysql.x4.large",
        "NodeNumber": 2,
        "SrcInstanceId": "vedbm-gzwdsf9b****",
        "VpcId": "vpc-13fz0iip9nlds3n6nu4fi****",
        "SubnetId": "subnet-13fz1bsbrsw743n6nu47c****",
        "ProjectName": "default",
        "ChargeType": "PostPaid",
        "RestoreTime": "2023-07-14T15:47:10Z",
        "Tags": [{
            "Key": "chargetype",
            "Value": "prepaid"
        }],
        "InstanceName": "Name123"
}

返回示例

正常返回示例

{
    "ResponseMetadata": {
        "RequestId": "202307192136280102090801470751B90C",
        "Action": "RestoreToNewInstance",
        "Version": "2022-01-01",
        "Service": "vedbm",
        "Region": "cn-beijing"
    },
    "Result": {
        "InstanceId": "vedbm-d4mx2akm****",
        "OrderId": "Order707643373078888****"
    }
}

错误码

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