调用 RestoreToNewInstance 接口将数据恢复到一个新实例。
异步请求。
当前不支持将单可用区实例恢复为多可用区实例,或将多可用区实例恢复为单可用区实例。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
SrcInstanceId | String | 是 | mysql-603e30e6**** | 备份数据所属的原实例的 ID。 |
BackupId | String | 否 | 2b18d7e970c442caae05be478a9e**** | 备份文件 ID。通过调用 DescribeBackups 可查询 BackupID。 说明
|
RestoreTime | String | 否 | 2022-01-01T10:10:10Z | 原实例备份保留周期内的任意时间点,格式为 yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。通过调用 DescribeRecoverableTime 可查询该时间点是否支持还原。 说明 该参数与 BackupId 参数二者必选其一。 |
NodeInfo | Object[] | 是 | [
{
"NodeType": "Primary",
"NodeSpec": "rds.mysql.d1.1c2g"
"ZoneId": "cn-beijing-a"
},
{
"NodeType": "Secondary",
"NodeSpec": "rds.mysql.d1.1c2g"
"ZoneId": "cn-beijing-a"
},
{
"NodeType": "ReadOnly",
"NodeSpec": "rds.mysql.d1.1c2g"
"ZoneId": "cn-beijing-a"
}
] | 实例规格配置。主节点和备节点有且只有 1 个,只读节点可选 0~10 个。 |
StorageType | String | 是 | LocalSSD | 实例存储类型。取值为 说明 在 ModifyDBInstanceSpec 接口中,如需设定 StorageSpace 参数,StorageType 参数为必传。 |
StorageSpace | Integer | 否 | 100 | 实例存储空间。取值范围:[20, 3000],单位为 GB,步长为 10GB。默认值为原实例空间大小。 |
VpcId | String | 是 | vpc-2d70di2hrnbpc58ozfdx9**** | 私有网络(VPC) ID。可调用 DescribeVpcs 查询。 说明 不支持使用共享 VPC。 |
SubnetId | String | 是 | subnet-2d70dj20bob9c58ozfek6**** | 子网 ID。 可调用 DescribeSubnets 通过指定 VpcId 和 ZoneId (主节点或备节点所在的可用区)查询可用的子网。 |
Port | Integer | 否 | 3306 | 默认终端的私网端口。端口号的取值范围为 1000~65534,默认值为 3306。 创建新的连接终端或开启新地址时,将使用默认终端的私网端口实时配置为默认端口。 |
AllowListIds | String[] | 否 | [
"acl-a29be2559dc4406883d358892b90****",
"acl-ded4c0b707e44efd8f0dbc4e88f5****"
] | 白名单 ID。如需绑定多个白名单,白名单 ID 用英文逗号(,)分隔。一个实例最多可绑定 100 个白名单。 说明 通过 RestoreToNewInstance 接口恢复到新实例时默认不会绑定源实例的白名单。如有需要,您可在调用该接口前,通过调用 DescribeAllowLists 查询源实例所绑定的白名单,并将其写入该字段;也可以在恢复到新实例后,通过调用 AssociateAllowList 接口绑定白名单到新实例。 |
InstanceName | String | 否 | Name123 | 实例名称。实例名称的命名规则如下:
|
DBParamGroupId | String | 否 | mysql-sys-6013c7b8f7ef**** | 参数模板 ID。默认值为数据库引擎版本对应的默认参数模板。 |
ProjectName | String | 否 | Test | 所属项目。 |
ChargeInfo | Object | 是 | {
"ChargeType": "PostPaid"
} | 付费方式。 |
InstanceTags | Object[] | 否 | [
{
"Key":"key1",
"Value":"value1"
},
{
"Key":"key2",
"Value":"value2"
}
] | 实例标签。 |
参数 | 类型 | 示例值 | 描述 |
---|---|---|---|
InstanceId | String | mysql-e7fda57b**** | 恢复的新实例的实例 ID。 |
OrderId | String | Order709899242175681**** | 订单 ID。 |
POST /?Action=RestoreToNewInstance&Version=2022-01-01 HTTP/1.1 Accept: application/json 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=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458**** { "SrcInstanceId": "mysql-603e30e6****", "BackupId": "9671e15707ca44a1b9d8c8fc3e9f****", "NodeInfo": [ { "NodeType": "Primary", "ZoneId": "cn-beijing", "NodeSpec": "rds.mysql.1c2g" }, { "NodeType": "Secondary", "ZoneId": "cn-beijing", "NodeSpec": "rds.mysql.1c2g" } ], "StorageType": "LocalSSD", "SubnetId": "subnet-2gcy3ey5i9reo50ztyzo6****", "VpcId": "vpc-3jhamu8itr5ds3pncmf9q****", "AllowListIds": [ "acl-3929ba6fd27049e88ee772dc7b46****" ], "Port": 3306, "InstanceName": "备份恢复样例", "ChargeInfo": { "ChargeType": "PostPaid" }, "InstanceTags": [ { "Key": "key1", "Value": "value1" }, { "Key": "key2", "Value": "value2" } ] }
{ "ResponseMetadata": { "RequestId": "202305081052028E9DB7D3AD66FA6FFCE0", "Action": "RestoreToNewInstance", "Version": "2022-01-01", "Service": "rds_mysql", "Region": "cn-beijing" }, "Result": { "InstanceId": "mysql-cd8ae4ca****", "OrderId": "Order7230637470966354220" } }
更多详情,请参见错误码。