API参考 - API参考 -备份恢复 - CloneDBInstance

描述


基于现有实例的备份文件或指定时间点克隆出一个带有当时数据的新实例。实例内的白名单设置、SQL审计设置、阈值报警设置、备份设置、参数设置将和当前实例状态保持一致。实例内的数据信息与备份文件当时信息一致。
克隆实例仅支持MySQL引擎，实例内数据库账号信息克隆将遵循如下方式：

• 若在克隆时，主实例为高权限账号状态，则克隆出的实例带有该主实例的高权限账号信息。
• 若克隆时，主实例为普通权限账号状态，则克隆出的实例带有所使用备份文件或时间点当时的账号信息。

创建克隆实例时，主实例需要满足如下条件：

• 实例状态为运行中，且没有被锁定。
• 当前没有迁移任务。
• 已开启数据备份和日志备份。
• 若要按备份集克隆实例，则主实例必须至少有一个已完成备份的备份集。
  [tr=transparent][/url]说明[tr=transparent]RDS支持RAM子账号创建克隆实例，请务必保证子账号已添加克隆实例的授权策略，添加授权请参见[url=https://help.aliyun.com/document_detail/58932.html]云数据库 RDS 授权。

请求参数

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述ActionString是系统规定参数，取值：CloneDBInstance。DBInstanceIdString是实例名。BackupIdString否

• 备份集ID，可通过查询备份列表接口DescribeBackups获取；
• BackupId和RestoreTime两者至少传入一个。

RestoreTimeString否

• 用户指定备份保留周期内的任意时间点，如2011-06-11T16:00:00Z；
• BackupId和RestoreTime两者至少传入一个。

PayTypeString是付费类型：

• Postpaid：按量付费
• Prepaid：预付费

PeriodString否

• 若付费类型为Prepaid则该入参必须传入；
• 指定预付费实例为包年或者包月类型；
• Year：包年
• Month：包月

UsedTimeString否包年包月类型：

• 若付费类型为Prepaid则该入参必须传入；
• 指定购买时长，可按需传入1、2、3等数值。

DBInstanceClassString否

• 实例规格，详见实例规格表
• 可选参数，若不传入，则默认规格和主实例一致。

DBInstanceStorageString否

• 磁盘空间，默认与主实例一致，单位GB，每5GB递增；
• RDS独占物理机规格可传入范围为[3000，3000]；
• 其它规格可传入范围为[5,2000]。

InstanceNetworkTypeString否网络类型：

• Classic：经典网络。
• VPC：VPC网络
• 默认与主实例网络类型一致。

VPCIdString否VPC ID。VSwitichIdString否VSwitich ID。PrivateIpAddressString否您可以指定VSwitchId下的VPCId，如果不输入，系统自动分配。

返回参数

[tr=rgb(51, 205, 229)][td]名称 类型描述<公共返回参数>无详见公共参数。DBInstanceId无实例名。[tr=rgb(239, 251, 255)][td]OrderId 无订单ID。