CreateDdrInstance
该接口用于跨地域恢复数据到新实例
服务地址:
华东1 金融云
输入参数
只看必填
RegionId目标地域ID
Engine目标数据库类型
EngineVersion目标数据库版本
DBInstanceClass目标实例规格
DBInstanceStorage目标实例存储空间
SystemDBCharset目标实例的字符集
DBInstanceNetType目标实例的网络连接类型
DBInstanceDescription目标实例名称
SecurityIPList目标实例的IP白名单
ClientToken用于保证请求的幂等性
PayType目标实例的付费类型
ZoneId目标实例的可用区ID
InstanceNetworkType目标实例的网络类型
ConnectionMode目标实例的访问模式
VPCId目标实例的VPC ID
VSwitchId目标实例的虚拟交换机ID
PrivateIpAddress设置目标实例的内网IP
UsedTime指定购买时长
Period指定预付费目标实例为包年或者包月类型
ResourceGroupId资源组ID
RestoreType恢复方式
BackupSetId基于备份集恢复时
BackupSetRegion备份集所在Region
RestoreTime基于时间点恢复时
SourceRegion基于时间点恢复时
SourceDBInstanceName基于时间点恢复时
DBInstanceStorageType目标实例存储类型
RoleARN主账号授权RDS云服务账号访问KMS权...
EncryptionKey用户自定义云盘加密的密钥ID
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

说明 恢复前可以调用 CheckCreateDdrDBInstance 接口预检查某 RDS 实例是否可以用跨地域备份集进行跨地域恢复。

适用引擎

  • RDS MySQL
  • RDS PostgreSQL
  • RDS SQL Server

相关功能文档

注意 使用该接口前,请仔细阅读功能文档,确保完全了解使用接口的前提条件及使用后造成的影响后,再进行操作。

请求参数

字段名称字段详情
RegionIdstring

目标地域 ID,可以通过接口 DescribeRegions 查看地域 ID。

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
Enginestring

目标数据库类型,取值:展开详情

示例值:MySQL
EngineVersionstring

目标数据库版本。根据 Engine 参数取值的不同,本参数取值如下:展开详情

示例值:5.6参考取值来源:
    DescribeDBMiniEngineVersions
DBInstanceClassstring

目标实例规格,详见实例规格表

示例值:rds.mysql.s1.small参考取值来源:
    CreateDBInstance
    DescribeDBInstances
DBInstanceStorageinteger<int32>

目标实例存储空间,取值:5~2000展开详情

示例值:20
SystemDBCharsetstring

目标实例的字符集,取值:展开详情

示例值:uft8
DBInstanceNetTypestring

目标实例的网络连接类型,取值:展开详情

示例值:Intranet参考取值来源:
    CreateDBInstance
    DescribeDBInstances
DBInstanceDescriptionstring

目标实例名称,长度为 2~256 个字符。以中文、英文字母开头,可以包含数字、中文、英文、下划线(_)、短横线(-)。展开详情

示例值:testdb
SecurityIPListstring

目标实例的 IP 白名单,多个 IP 地址请以半角逗号(,)隔开,不可重复,最多 1000 个。支持如下两种格式:展开详情

示例值:127.0.0.1参考取值来源:
    DescribeDBInstanceIPArrayList
    CreateDBInstance
ClientTokenstring

用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过 64 个 ASCII 字符,且该参数值中不能包含非 ASCII 字符。

示例值:ETnLKlblzczshOTUbOCz****
PayTypestring

目标实例的付费类型,取值:展开详情

示例值:Prepaid
ZoneIdstring

目标实例的可用区 ID。多可用区用英文冒号(:)分隔。展开详情

示例值:cn-hangzhou-b
InstanceNetworkTypestring

目标实例的网络类型,取值:展开详情

示例值:Classic参考取值来源:
    DescribeDBInstanceNetInfo
ConnectionModestring

目标实例的访问模式,取值:展开详情

示例值:Standard
VPCIdstring

目标实例的 VPC ID。当 InstanceNetworkType=VPC 时,本参数可用。展开详情

示例值:vpc-****
VSwitchIdstring

目标实例的虚拟交换机 ID,多个值用半角逗号(,)隔开。当 InstanceNetworkType=VPC 时,本参数可用。展开详情

示例值:vsw-****参考取值来源:
    DescribeVSwitches
PrivateIpAddressstring

设置目标实例的内网 IP,需要在指定交换机的 IP 地址范围内。系统默认通过 VPCIdVSwitchId 自动分配。

示例值:172.XX.XX.69
UsedTimestring

指定购买时长,取值:展开详情

示例值:2
Periodstring

指定预付费目标实例为包年或者包月类型,取值:展开详情

示例值:Year
ResourceGroupIdstring

资源组 ID。

示例值:rg-acfmy****参考取值来源:
    DescribeResourceDetails
RestoreTypestring

恢复方式,取值:展开详情

示例值:BackupSet枚举值:BackupSetBackupTime01
BackupSetIdstring

基于备份集恢复时,使用的备份集的 ID。可以通过接口 DescribeCrossRegionBackups 查看备份集 ID。展开详情

示例值:14****
BackupSetRegionstring

备份集所在 Region。

示例值:cn-beijing
RestoreTimestring

基于时间点恢复时,要恢复的时间节点,需要早于当前时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。展开详情

示例值:2019-05-30T03:29:10Z
SourceRegionstring

基于时间点恢复时,源地域的 ID。展开详情

示例值:cn-hangzhou
SourceDBInstanceNamestring

基于时间点恢复时,源实例的 ID。展开详情

示例值:rm-uf6wjk5****
DBInstanceStorageTypestring

目标实例存储类型,当前仅支持 SSD 本地盘,默认值:local_ssd

示例值:local_ssd参考取值来源:
    CreateDBInstance
    DescribeDBInstances
RoleARNstring

主账号授权 RDS 云服务账号访问 KMS 权限的全局资源描述符(ARN)。您可以通过 CheckCloudResourceAuthorized 接口查看 ARN 信息。展开详情

示例值:acs:ram::1406****:role/aliyunrdsinstanceencryptiondefaultrole
EncryptionKeystring

用户自定义云盘加密的密钥 ID。传入此参数表示开启云盘加密(开启后无法关闭),并且需要传入 RoleARN展开详情

示例值:749c1df7-****-****-****-****参考取值来源:
    DescribeDBInstanceEncryptionKey

返回参数

字段名称字段详情
ConnectionStringstring

新实例连接地址。展开详情

示例值:rm-****.mysql.rds.aliyuncs.com
DBInstanceIdstring

新实例 ID。

示例值:rm-****
OrderIdstring

订单 ID。

示例值:2038691****
Portstring

新实例连接端口。展开详情

示例值:3306
RequestIdstring

请求 ID。

示例值:E52666CC-330E-418A-8E5B-A19E3FB42D13
变更历史
暂无变更历史