跨域恢复到新实例
更新时间 2025-09-11 11:32:07
最近更新时间: 2025-09-11 11:32:07
接口功能介绍
跨域恢复到新实例
接口约束
源实例存在且开启跨域备份,备份id所标识的备份已经完成跨域同步。 调用open-api所选的资源池为源实例所在资源池
URI
POST /RDS2/v1/open-api/order/cross-recovery
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
sourceInstId | 是 | String | 源实例id | testinstance1 | |
regionId | 是 | String | 跨域恢复目标资源池ID | cn-test | |
billMode | 是 | Byte | 计费模式,1是包周期,2是按需 | ||
hostType | 是 | String | 主机类型:“S7” or "S6" | S7 | |
mysqlNodeInfoList | 是 | Array of Objects | mysql节点列表,此列表长度必须为1 | mysqlNodeInfoList | |
backupId | 是 | Long | 备份id | 1 | |
vpcId | 是 | String | 新实例虚拟私有云id(目标资源池) | test-vpc | |
subnetId | 是 | String | 新实例子网id(目标资源池) | test-subnet | |
securityGroupId | 是 | String | 新实例安全组id(目标资源池) | test-security-group | |
name | 是 | String | 新实例名称 | test-instance-name | |
autoScaleParam | 否 | Object | 自动扩容参数,默认不开启自动扩容 | autoScaleParam | |
password | 否 | String | 新实例密码 | test@Password | |
period | 否 | Integer | 订购时间,单位为月,默认为6 | 6 | |
count | 否 | Integer | 订购数量,默认为1 | 1 | |
autoRenewStatus | 否 | Integer | 自动续订状态,0代表不自动续订,1代表自动续订,默认为1 | 1 | |
timeZone | 否 | String | 实例时区,默认为“+8:00” | +8:00 | |
projectId | 否 | String | 企业项目id,默认为“0” | 0 | |
表 mysqlNodeInfoList |
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
nodeType | 是 | String | master:实例规格(单机,一主一备,一主两备) | master | |
instSpec | 是 | String | 实例规格(默认:通用型=1) | ||
storageType | 是 | String | 存储类型: SSD=超高IO、SATA=普通IO、SAS=高IO、SSD-genric=通用型SSD、FAST-SSD=极速型SSD | ||
storageSpace | 是 | Integer | 存储空间(单位:G,范围100,32768) | 100 | |
prodPerformanceSpec | 是 | String | 规格(例: 4C8G) | ||
disks | 是 | Integer | 磁盘(默认为1) | 1 | |
availabilityZoneInfo | 是 | Array of Objects | 可用区信息 | availabilityZoneInfo | |
表 availabilityZoneInfo |
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
availabilityZoneName | 是 | String | 资源池可用区名称 | ||
availabilityZoneCount | 是 | Integer | 资源池可用区总数 | 1 | |
nodeType | 是 | String | 表示分布AZ的节点类型,取值 master/slave, 有且仅有一个master节点, 最多两个slave节点 | ||
表 autoScaleParam |
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
autoScale | 是 | Integer | 是否开启自动扩容,0 不开启, 1 开启 | ||
maxScale | 是 | Integer | 存储扩容上线,单位GB | ||
activeScaleRate | 是 | Integer | 触发存储扩容百分比, 取值 1-100 |
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 返回码 取值范围:0 成功; 2001 参数异常;3001 业务异常;5001 请求响应失败 | 0 | |
returnObj | Object | 返回对象 | returnObj | |
message | String | 结果信息 | success | |
error | String | 错误码。当接口失败时才返回具体错误编码,成功不返回或者为空 | MYSQL_10001 | |
表 returnObj |
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
data | Object | 返回数据 | data | |
表 data |
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
newOrderNo | String | 订单编号 | 2024 | |
submitted | Boolean | 订单是否提交 | true | |
totalPrice | Float | 订单价格,单位元 | 160.0 | |
newOrderId | String | 订单id | 20f6 | |
errorMessage | String | 错误信息 |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
{
"billMode":"1",
"regionId":"test-region",
"hostType":"S7",
"mysqlNodeInfoList":[
{
"nodeType": "master",
"instSpec": 1,
"storageType": "SAS",
"storageSpace": 100,
"prodPerformanceSpec": "2C4G",
"disks": 1,
"availabilityZoneInfo": [
{
"availabilityZoneName": "cn-test-1A",
"availabilityZoneCount": 1,
"nodeType": "master"
},
{
"availabilityZoneName": "cn-test-2A",
"availabilityZoneCount": 1,
"nodeType": "slave"
}
]
}
],
"sourceInstId":"test-instance",
"backupId":"33732",
"vpcId":"vpc-test",
"subnetId":"subnet-test",
"securityGroupId":"sg-test",
"name":"mysql-test",
"period":1,
"count":1
}
响应示例
{
"statusCode": 0,
"message": "success",
"returnObj": {
"data":{
"newOrderNo":"20241104",
"submitted":true,
"totalPrice":160.0,
"newOrderId":"testorder",
"errorMessage":""
}
}
}
状态码
请参考 状态码
错误码
请参考 错误码