恢复到新实例_云数据库 RDS

功能介绍

从备份恢复到新实例。

调用接口前，您需要了解API 认证鉴权。
调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

接口约束

源实例和目标实例的数据库类型必须一致，如都是MySQL。
RDS所有引擎的源实例和目标实例的数据库版本必须一致。
目标实例的数据卷总大小，大于或等于源实例的数据卷总大小。

URI

URI格式
 POST https://{Endpoint}/v3/{project_id}/instances
URI样例
 https://rds.my-kualalumpur-1.alphaedge.tmone.com.my/v3/0483b6b16e954cb88930a360d2c4e663/instances

参数说明

表1 参数说明
名称	是否必选	说明
project_id	是	租户在某一region下的project ID。获取方法请参见获取项目ID。

请求消息

参数说明

表2 参数说明
名称	是否必选	参数类型	说明
name	是	String	实例名称。取值范围：4~64个字符之间，必须以字母开头，不区分大小写，可以包含字母、数字、中划线或者下划线，不能包含其他的特殊字符。
ha	否	Object	HA配置参数，创建HA实例时使用。详情请参见表3。
configuration_id	否	String	参数模板ID。
port	否	String	数据库端口信息。 MySQL数据库端口设置范围为1024～65535（其中12017和33071被RDS系统占用不可设置）。 PostgreSQL数据库端口修改范围为2100～9500。 Microsoft SQL Server实例的端口设置范围为1433和2100~9500（其中5355和5985不可设置）。当不传该参数时，默认端口如下： MySQL默认3306。 PostgreSQL默认5432。 Microsoft SQL Server默认1433。
password	是	String	数据库密码。取值范围：非空，由大小写字母、数字和特殊符号~!@#%^*-_=+?组成，长度8~32个字符。建议您输入高强度密码，以提高安全性，防止出现密码被暴力破解等安全风险。
backup_strategy	否	Object	高级备份策略。详情请参见表4。
flavor_ref	是	String	规格码，取值范围：非空,。详情请参考查询数据库规格的响应消息中的“spec_code”。
volume	是	Object	volume信息。详情请参见表5。
availability_zone	是	String	可用区ID。对于数据库实例类型不是单机的实例，需要分别为实例所有节点指定可用区，并用逗号隔开。详见示例。取值范围：非空，请参见地区和终端节点。
vpc_id	是	String	虚拟私有云ID，获取方法如下：方法1：登录虚拟私有云服务的控制台界面，在虚拟私有云的详情页面查找VPC ID。方法2：获取方法请参见《虚拟私有云API参考》中“查询VPC列表”的内容。
subnet_id	是	String	子网的网络ID信息，获取方法如下：方法1：登录虚拟私有云服务的控制台界面，单击VPC下的子网，进入子网详情页面，查找网络ID。方法2：获取方法请参见《虚拟私有云API参考》中“查询子网列表”的内容。
security_group_id	否	String	指定实例所属的安全组。方法1：登录虚拟私有云服务的控制台界面，在安全组的详情页面查找安全组ID。方法2：获取方法请参见《虚拟私有云API参考》中“查询安全组列表”的内容。
restore_point	是	Object	恢复数据源对象。详情请参见表6。
time_zone	否	String	UTC时区。不选择时，各个引擎时区如下： MySQL国内站、国际站默认为UTC时间。 PostgreSQL国内站、国际站默认为UTC时间。 Microsoft SQL Server国内站默认为UTC+08:00，国际站默认为UTC时间。选择填写时，取值范围为UTC-12:00~UTC+12:00，且只支持整段时间，如UTC+08:00，不支持UTC+08:30。

表3 ha字段数据结构说明
名称	是否必选	参数类型	说明
mode	是	String	实例主备模式，取值：Ha（主备），不区分大小写。
replication_mode	是	String	备机同步参数。取值：非空。 MySQL为“async”或“semisync”。 PostgreSQL为“async”或“sync”。 Microsoft SQL Server为“sync”。说明： “async”为异步模式。 “semisync”为半同步模式。 “sync”为同步模式。

表4 backup_strategy字段数据结构说明
名称	是否必选	参数类型	说明
start_time	是	String	备份时间段。自动备份将在该时间段内触发。取值范围：非空，格式必须为hh:mm-HH:MM且有效，当前时间指UTC时间。 HH取值必须比hh大1。 mm和MM取值必须相同，且取值必须为00、15、30或45。取值示例： 08:15-09:15 23:00-00:00
keep_days	否	Integer	指定备份文件的可保存天数。取值范围：0～732。该参数缺省，或取值为0，表示关闭自动备份策略。如果需要延长保留时间请联系客服人员申请，自动备份最长可以保留2562天。

表5 volume字段数据结构说明
名称	是否必选	参数类型	说明
type	是	String	磁盘类型。取值范围如下，区分大小写： ULTRAHIGH，表示SSD。 ULTRAHIGHPRO，表示SSD尊享版，仅支持超高性能型尊享版。
size	是	Integer	磁盘大小。取值范围：40GB~4000GB。必须为10的整数倍。须知：新实例磁盘大小必须大于或等于原实例的磁盘大小。

表6 restore_point字段数据结构说明
名称	是否必选	参数类型	说明
instance_id	是	String	实例ID。
type	是	String	表示恢复方式，枚举值： “backup”，表示使用备份文件恢复，按照此方式恢复时，当“type”字段为非必选时，“backup_id”必选。 “timestamp”，表示按时间点恢复，按照此方式恢复时，当“type”字段必选时，“restore_time”必选。
backup_id	否	String	用于恢复的备份ID。当使用备份文件恢复时需要指定该参数。须知：当“type”字段为非必选时，“backup_id”必选。
restore_time	否	Integer	恢复数据的时间点，格式为UNIX时间戳，单位是毫秒，时区为UTC。须知：当“type”字段必选时，“restore_time”必选。

请求样例

使用备份文件恢复：

MySQL/PostgeSQL:

{
	"name": "targetInst",
	"availability_zone": "bbb,ccc",
	"ha": {
		"mode": "ha",
		"replication_mode": "async"
	},
	"flavor_ref": "rds.mysql.s1.large",
	"volume": {
		"type": "ULTRAHIGH",
		"size": 40
	},
	"disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4",
	"vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce",
	"subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f",
	"security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5",
	"backup_strategy": {
		"keep_days": 2,
		"start_time": "19:00-20:00"
	},
	"password": "Demo@12345678",
	"configuration_id": "52e86e87445847a79bf807ceda213165pr01",
	"enterprise_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c",
	"time_zone": "UTC+04:00",
	"restore_point": {
		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01",
		"type": "backup",
		"backup_id": "2f4ddb93-b901-4b08-93d8-1d2e472f30fe"
	}
}

Microsoft SQL Server：

{
	"name": "targetInst",
	"availability_zone": "bbb,ccc",
	"ha": {
		"mode": "ha",
		"replication_mode": "sync"
	},
	"flavor_ref": "rds.mssql.2014.se.s3.xlarge.2.ha",
	"volume": {
		"type": "ULTRAHIGH",
		"size": 40
	},
	"disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4",
	"vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce",
	"subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f",
	"security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5",
	"backup_strategy": {
		"keep_days": 2,
		"start_time": "19:00-20:00"
	},
	"password": "Demo@12345678",
	"configuration_id": "52e86e87445847a79bf807ceda213165pr04",
	"enterprise_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c",
	"time_zone": "UTC+04:00",
	"restore_point": {
		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin04",
		"type": "backup",
		"backup_id": "2f4ddb93-b901-4b08-93d8-1d2e472f30fe",
		"database_name": {
			"db1": "dbtest1",
			"db2": ""
		}
	}
}

按时间点恢复：

{
	"name": "targetInst",
	"availability_zone": "bbb,ccc",
	"ha": {
		"mode": "ha",
		"replication_mode": "async"
	},
	"flavor_ref": "rds.mysql.s1.large",
	"volume": {
		"type": "ULTRAHIGH",
		"size": 40
	},
	"disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4",
	"vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce",
	"subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f",
	"security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5",
	"backup_strategy": {
		"keep_days": 2,
		"start_time": "19:00-20:00"
	},
	"password": "Demo@12345678",
	"configuration_id": "52e86e87445847a79bf807ceda213165pr01",
	"enterprise_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c",
	"time_zone": "UTC+04:00",
	"restore_point": {
		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin01",
		"type": "timestamp",
		"restore_time": 1532001446987
	}
}

Microsoft SQL Server：

{
	"name": "targetInst",
	"availability_zone": "bbb,ccc",
	"ha": {
		"mode": "ha",
		"replication_mode": "sync"
	},
	"flavor_ref": "rds.mssql.2014.se.s3.xlarge.2.ha",
	"volume": {
		"type": "ULTRAHIGH",
		"size": 40
	},
	"disk_encryption_id": "2gfdsh-844a-4023-a776-fc5c5fb71fb4",
	"vpc_id": "490a4a08-ef4b-44c5-94be-3051ef9e4fce",
	"subnet_id": "0e2eda62-1d42-4d64-a9d1-4e9aa9cd994f",
	"security_group_id": "2a1f7fc8-3307-42a7-aa6f-42c8b9b8f8c5",
	"backup_strategy": {
		"keep_days": 2,
		"start_time": "19:00-20:00"
	},
	"password": "Demo@12345678",
	"configuration_id": "52e86e87445847a79bf807ceda213165pr04",
	"enterprise_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c",
	"time_zone": "UTC+04:00",
	"restore_point": {
		"instance_id": "d8e6ca5a624745bcb546a227aa3ae1cfin04",
		"type": "timestamp",
		"restore_time": 1532001446987,
		"database_name": {
			"db1": "dbtest1",
			"db2": ""
		}
	}
}

响应消息

正常响应要素说明

表7 要素说明
名称	参数类型	说明
instance	Object	实例信息。详情请参见表8。
job_id	String	实例创建的任务id。

表8 instance说明
名称	参数类型	说明
id	String	实例id。
name	String	实例名称。用于表示实例的名称，同一租户下，同类型的实例名可重名，其中，SQL Server实例名唯一。取值范围：4~64个字符之间，必须以字母开头，不区分大小写，可以包含字母、数字、中划线或者下划线，不能包含其他的特殊字符。
status	String	实例状态。如BUILD，表示创建中。
datastore	Object	数据库信息。详情请参见表9。
ha	Object	HA配置参数，仅当您选择创建HA实例时该参数才可见。详情请参见表10。
configuration_id	String	参数模板id，仅当您创建实例指定用户自定义参数组时才可见。
port	String	数据库端口信息。 MySQL数据库端口设置范围为1024～65535（其中12017和33071被RDS系统占用不可设置）。 PostgreSQL数据库端口修改范围为2100～9500。 Microsoft SQL Server实例的端口设置范围为1433和2100~9500（其中5355和5985不可设置）。当不传该参数时，默认端口如下： MySQL默认3306。 PostgreSQL默认5432。 Microsoft SQL Server默认1433。
backup_strategy	Object	自动备份策略。详情请参见表11。
flavor_ref	String	规格ID。使用可参考查询数据库规格响应消息表3中的“spec_code”。
volume	Object	volume信息。详情请参见表12。
region	String	区域ID。
availability_zone	String	可用区ID。
vpc_id	String	虚拟私有云ID，获取方法如下：方法1：登录虚拟私有云服务的控制台界面，在虚拟私有云的详情页面查找VPC ID。方法2：获取方法请参见《虚拟私有云API参考》中“查询VPC列表”的内容。
subnet_id	String	子网的网络ID信息，获取方法如下：方法1：登录虚拟私有云服务的控制台界面，单击VPC下的子网，进入子网详情页面，查找网络ID。方法2：获取方法请参见《虚拟私有云API参考》中“查询子网列表”的内容。
security_group_id	String	指定实例所属的安全组。方法1：登录虚拟私有云服务的控制台界面，在安全组的详情页面查找安全组ID。方法2：获取方法请参见《虚拟私有云API参考》中“查询安全组列表”的内容。

表9 datastore字段数据结构说明
名称	是否必选	参数类型	说明
type	是	String	数据库引擎。支持的引擎如下，不区分大小写： MySQL PostgreSQL SQLServer
version	是	String	数据库版本。数据库支持的详细版本信息，可调用查询数据库引擎的版本接口获取。

**表10** ha字段数据结构说明
名称	是否必选	参数类型	说明
mode	是	String	实例主备模式，取值：Ha（主备）。
replication_mode	是	String	备机同步参数。取值：非空。 MySQL为“async”或“semisync”。 PostgreSQL为“async”或“sync”。 Microsoft SQL Server为“sync”。说明： “async”为异步模式。 “semisync”为半同步模式。 “sync”为同步模式。

**表11** backupStrategy字段数据结构说明
名称	是否必选	参数类型	说明
start_time	是	String	备份时间段。自动备份将在该时间段内触发。取值范围：非空，格式必须为hh:mm-HH:MM且有效，当前时间指UTC时间。 HH取值必须比hh大1。 mm和MM取值必须相同，且取值必须为00、15、30或45。取值示例： 08:15-09:15 23:00-00:00
keep_days	否	Integer	指定已生成备份文件的可保存天数。取值范围：0～732。该参数缺省，或取0值，表示关闭自动备份策略。如果需要延长保留时间请联系客服人员申请，自动备份最长可以保留2562天。

**表12** volume字段数据结构说明
名称	是否必选	参数类型	说明
type	是	String	磁盘类型。取值范围如下，区分大小写： ULTRAHIGH，表示SSD。
size	是	Integer	磁盘大小。取值范围：40GB~4000GB。必须为10的整数倍。

正常响应样例

{
	"instance": {
		"id": "f5ffdd8b1c98434385eb001904209eacin01",
		"name": "demoname",
		"status": "BUILD",
		"datastore": {
			"type": "MySQL",
			"version": "5.6.41"
		},
		"port": "3306",
		"volume": {
			"type": "ULTRAHIGH",
			"size": "40"
		},
		"region": "aaa",
		"backup_strategy": {
			"start_time": "02:00-03:00",
			"keep_days": "7"
		},
		"flavor_ref": "rds.mysql.s1.large",
		"availability_zone": "bbb",
		"vpc_id": "19e5d45d-70fd-4a91-87e9-b27e71c9891f",
		"subnet_id": "bd51fb45-2dcb-4296-8783-8623bfe89bb7",
		"security_group_id": "23fd0cd4-15dc-4d65-bdb3-8844cc291be0"
	},
	"job_id": "bf003379-afea-4aa5-aa83-4543542070bc"
}

异常响应
 请参见异常请求结果。

状态码

请参见状态码。

错误码

请参见错误码。

恢复到新实例

功能介绍

接口约束

URI

请求消息

响应消息

状态码

错误码

意见反馈

文档内容是否对您有帮助？