CloneDBInstance_云数据库 RDS_API文档-阿里云OpenAPI开发者门户

接口说明

适用引擎

RDS MySQL
RDS PostgreSQL
RDS SQL Server
RDS MariaDB

流控信息

请求速率为10/1(s)。更多流控信息，请前往配额中心查看

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

rds:CloneDBInstance	Create	DBInstance acs:rds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}	rds:ResourceTag	无

请求参数

字段名称	字段详情
ClientTokenstring	用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过 64 个 ASCII 字符，且该参数值中不能包含非 ASCII 字符。示例值:0c593ea1-3bea-11e9-b96b-88**********
RegionIdstring	地域 ID。可以通过接口 DescribeRegions 查看地域 ID。示例值:cn-hangzhou参考取值来源: DescribeRegions
ZoneIdstring	主可用区 ID。可以通过接口 DescribeRegions 查看可用区 ID。展开详情示例值:cn-hangzhou-b
DBInstanceClassstring	实例规格，详见实例规格表。展开详情示例值:mysql.n1.micro.1参考取值来源: CreateDBInstance DescribeDBInstances
DBInstanceStorageinteger<int32>	实例存储空间，单位：GB。每 5GB 进行递增，详见实例规格表。展开详情示例值:1000
DBInstanceDescriptionstring	实例名称。长度为 2~255 个字符。以中文、英文字母开头，可以包含数字、中文、英文、下划线（_）、短横线（-）。展开详情示例值:testInstance
DbNamesstring	数据库名称，格式如下：`原库名 1,原库名 2`。示例值:test1,test2
PayTypestring	付费类型，取值：展开详情示例值:Postpaid
InstanceNetworkTypestring	实例的网络类型，取值：展开详情示例值:VPC参考取值来源: DescribeDBInstanceNetInfo
DBInstanceIdstring	实例 ID。示例值:rm-uf6wjk5****参考取值来源: CreateDBInstance ReceiveDBInstance ModifyDBInstanceSpec RecoveryDBInstance DescribeDBInstances GetDbProxyInstanceSsl CalculateDBInstanceWeight MigrateDBNodes UpgradeDBInstanceMajorVersion TransformDBInstancePayType EvaluateLocalExtendDisk RestoreDdrTable RebuildReplicationLink 字符长度 <= 65535字符长度 >= 1
BackupIdstring	备份集 ID。展开详情示例值:902****参考取值来源: DescribeBackups ImportUserBackupFile UpdateUserBackupFile ListUserBackupFiles
RestoreTimestring	备份保留周期内的任意时间点。格式：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。展开详情示例值:2011-06-11T16:00:00Z
VPCIdstring	专有网络 VPC ID。展开详情示例值:vpc-uf6f7l4fg90****
VSwitchIdstring	虚拟交换机 ID。虚拟交换机所在的可用区必须和 ZoneId 中传入的可用区 ID 相对应。展开详情示例值:vsw-uf6adz52c2p****参考取值来源: DescribeVSwitches
PrivateIpAddressstring	新实例的内网 IP，需要在指定交换机的 IP 地址范围内。系统默认通过 VPCId 和 VSwitchId 自动分配。示例值:172.XX.XX.69
UsedTimeinteger<int32>	购买时长，取值：展开详情示例值:1
Periodstring	预付费实例为包年或者包月类型，取值：展开详情示例值:Year枚举值:YearMonth
Categorystring	实例系列，取值：展开详情示例值:HighAvailability
ZoneIdSlave1string	备节点可用区 ID。如果和 ZoneId 相同，则为单可用区部署；如果和 ZoneId 不同，则为多可用区部署。示例值:cn-hangzhou-c
ZoneIdSlave2string	备节点或日志节点可用区 ID。如果和 ZoneId 相同，则为单可用区部署；如果和 ZoneId 不同，则为多可用区部署。示例值:cn-hangzhou-d
DBInstanceStorageTypestring	实例存储类型，取值：展开详情示例值:general_essd参考取值来源: CreateDBInstance DescribeDBInstances
RestoreTablestring	是否进行库表恢复，取值为 1 时表示进行库表恢复，否则不填。示例值:1
TableMetastring	进行库表恢复时，指定恢复的库表信息。格式：展开详情示例值:[{"type":"db","name":"testdb1","newname":"testdb1_new","tables":[{"type":"table","name":"testdb1table1","newname":"testdb1table1_new"}]}]
DedicatedHostGroupIdstring	专属集群 ID。示例值:dhg-7a9****参考取值来源: DescribeDedicatedHostGroups
BackupTypestring	备份类型，取值：展开详情示例值:FullBackup参考取值来源: DescribeBackups
DeletionProtectionboolean	是否开启释放保护功能。取值：展开详情示例值:true
ServerlessConfigobject	Serverless 选项。仅在需要将数据克隆至 Serverless 实例时传入。展开详情
BpeEnabledstring	弃用参数，无需配置。示例值:0
IoAccelerationEnabledstring	是否开启通用云盘 IO 加速功能，参数取值含义如下：展开详情示例值:0
BurstingEnabledboolean	通用云盘 IO 突发功能开关。展开详情示例值:false
AutoPayboolean	是否自动支付。展开详情示例值:true

返回参数

字段名称	字段详情
DBInstanceIdstring	实例 ID。示例值:rm-uf6wjk5****
OrderIdstring	订单 ID。示例值:100789370****
RequestIdstring	请求 ID。示例值:1E43AAE0-BEE8-43DA-860D-EAF2****

返回示例

变更历史

	变更时间	变更内容概要	操作
	2025-03-31	变更错误码400
	2025-02-28	变更错误码400
	2024-10-30	变更错误码400
	2024-09-26	新增请求参数DBInstanceDescription
	2024-08-20	变更错误码400
	2024-06-07	变更错误码400
	2024-05-10	变更错误码403
	2024-01-04	新增请求参数IoAccelerationEnabled 新增请求参数BurstingEnabled

1
2
10 条/页

CloneDBInstance_云数据库 RDS_API文档

接口说明

适用引擎

相关功能文档

流控信息

授权信息

请求参数

返回参数

返回示例

变更历史

相关示例