调用 RestoreToNewInstance 接口将已有实例的备份数据恢复至一个新的实例中。
异步请求。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
SrcInstanceId | String | 是 | vedbm-h441603c68aaa**** | 备份文件所属原实例的 ID。 说明 您可以调用 DescribeDBInstances 接口查询实例 ID。 |
BackupId | String | 否 | snap-64b7****-5935 | 原实例的备份文件 ID,使用该备份文件中保存的数据创建新实例。 说明
|
RestoreTime | String | 否 | 2023-07-14T15:47:10Z | 原实例日志备份保留时间内的任意时间点,格式为 yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。 说明
|
ZoneIds | String | 是 | cn-beijing-a | 可用区 ID。 说明 您可以调用 DescribeAvailabilityZones 接口查询 veDB MySQL 实例支持的可用区资源。 |
DBMinorVersion | String | 否 | 3.0 | 选择 veDB MySQL 小版本,默认与原实例保持一致。关于版本号的详细说明请参见版本号管理。
说明
|
NodeSpec | String | 是 | vedb.mysql.x4.large | 实例的规格代码。详细信息,请参见产品规格。 |
NodeNumber | Integer | 是 | 2 | 实例的节点数量。取值范围为 2~16 个。 |
VpcId | String | 是 | vpc-3ajzohyfaru9s340jz1rp**** | 私有网络(VPC) ID。 说明 您可以调用 DescribeVpcs 接口查询要创建实例的 VPC ID。 |
SubnetId | String | 是 | subnet-1g15j13jtzgu88ibuxwqp**** | 子网 ID。子网必须属于所选的可用区。 说明
|
Port | Integer | 否 | 3306 | 为实例默认创建的连接终端指定私网端口号。默认取值为 3306,取值范围为 1000~65534。 说明
|
ChargeType | String | 是 | PostPaid | 付费类型,取值:
|
InstanceName | String | 否 | Name123 | 实例名称。命名规则:
|
ProjectName | String | 否 | default | 实例所属的项目名称,当该参数留空时,新建的实例默认加入 default 项目。 |
Tags | Array of TagObject | 否 | 请参见请求示例。 | 需要绑定的标签键和标签值数组对象。关于 Tags 的更多详情,请参见 TagObject。 说明
|
AutoRenew | Boolean | 否 | false | 预付费场景下是否自动续费。取值:
说明 当 |
PeriodUnit | String | 否 | Month | 预付费场景下的购买周期。
说明 当 |
Period | Integer | 否 | 1 | 预付费场景下的购买时长。 说明 当 |
PrePaidStorageInGB | Integer | 否 | 50 | 预付费场景下的存储空间大小, 说明 当 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
InstanceId | String | vedbm-h441603c68aaa**** | 实例 ID。 |
OrderId | String | Order707643373078888**** | 订单 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****" } }
更多详情,请参见错误码。