CheckCreateDrDBInstance接口用于预检查某RDS实例是否可以用跨地域备份集进行跨地域恢复,该接口通过一系列参数的设置和验证,确保目标实例满足跨地域恢复的条件,以下是对该接口的详细解析:
接口
CheckCreateDrDBInstance接口主要用于在创建新实例之前,对目标数据库实例进行预检查,以确保其能够成功利用跨地域备份集进行数据恢复。
请求参数
参数名称 | 类型 | 描述 | 示例值 |
RegionId | string | 目的实例地域 ID,可以通过接口DescribeRegions查看地域 ID。 | cn-hangzhou |
Engine | string | 目标数据库类型,取值:MySQL、SQLServer、PostgreSQL。 | MySQL |
EngineVersion | string | 目标数据库版本,根据Engine参数取值的不同,本参数取值也有所不同。 | 5.6 |
DBInstanceClass | string | 目的实例规格,详见实例规格表。 | rds.mysql.s1.small |
DBInstanceStorage | integer | 目的实例存储空间,取值范围为5~2000GB,每5G递增。 | 20 |
SystemDBCharset | string | 目标实例的字符集,取值:utf8、gbk、latin1、utf8mb4。 | utf8 |
DBInstanceNetType | string | 目标实例的网络连接类型,取值:Internet、Intranet。 | Intranet |
SecurityIPList | string | 目标实例的IP白名单,多个IP地址请以半角逗号(,)隔开,不可重复,最多支持1000个IP。 | 127.0.0.1 |
DBInstanceDescription | string | 目标实例名称,长度为2~256个字符,以中文、英文字母开头,可以包含数字、中文、英文、下划线(_),但不能包含http://和https://开头的URL。 | testdb |
PayType | string | 目标实例的付费类型,取值:Postpaid(按量付费)、Prepaid(预支付)。 | Prepaid |
ZoneId | string | 目标实例的可用区 ID,多可用区用英文冒号(:)分隔。 | cn-hangzhou-b |
VpcId | string | 当InstanceNetworkType=VPC时,此参数必传,VPC ID。 | vpc |
VSwitchId | string | 当InstanceNetworkType=VPC时,此参数必传,虚拟交换机ID,多个值用半角逗号(,)隔开。 | vsw |
PrivateIpAddress | string | 设置目标实例的内网IP,需要在指定交换机的IP地址范围内。 | 172.XX.XX.69 |
UsedTime | string | 指定购买时长,若付费类型为预付费则此参数必须传入。 | 2 |
Period | string | 指定预付费目标实例包年包月或者按量付费类型。 | Year |
RestoreType | string | 恢复方式,取值:0(基于备份集恢复)、1(基于时间点恢复)。 | 0 |
BackupSetId | string | 基于备份集恢复时,使用的备份集的ID。 | bkp |
RestoreTime | string | 基于时间点恢复时,要恢复的时间节点,需要早于当前时间。 | 2024-11-28T00:00:00Z |
SourceRegion | string | 基于时间点恢复时,源地域的ID。 | cn-hangzhou |
SourceDBInstanceName | string | 基于时间点恢复时,源实例ID。 | sourcedb |
ClientToken | string | 用于保证请求的幂等性,最大值不能超过64个ASCII字符,且不能包含非ASCII字符。 | ETnLlbzshczOTUbOCz |
PayType | string | 目标实例的付费类型,取值:Postpaid(按量付费)、Prepaid(预支付)。 | Prepaid |
ResourceGroupId | string | 资源组ID。 | rg-acfmy |
返回结果
参数名称 | 类型 | 描述 | 示例值 |
IsValid | boolean | 是否能创建容灾恢复实例,取值:true(可以)、false(不可以)。 | true |
RequestId | string | 请求 ID。 | 400 |
IncorrectDBInstanceType | string | 操作失败时的错误信息,当前数据库实例引擎和类型不支持操作”。 | 400 |
常见问题FAQ
CheckCreateDrDBInstance接口调用失败可能的原因有哪些?
1、无效的数据库引擎或类型:确保提供的数据库引擎(如MySQL、SQLServer、PostgreSQL)和版本(如MySQL 5.5/5.6/5.7/8.0)是有效的。
2、错误的恢复方式:检查RestoreType参数是否设置正确,基于备份集恢复时需提供BackupSetId,基于时间点恢复时需提供RestoreTime、SourceRegion和SourceDBInstanceName。
3、网络配置问题:如果设置了VpcId、VSwitchId或PrivateIpAddress,请确保这些参数的配置是正确的,并且与您的网络环境相匹配。
4、付费类型问题:如果付费类型设置为预付费(Prepaid),但未提供UsedTime和Period参数,或者这两个参数的值不在有效范围内,也会导致调用失败。
5、其他参数错误:如DBInstanceClass、DBInstanceStorage等参数设置不正确或超出范围。
CheckCreateDrDBInstance接口调用成功的条件是什么?
1、所有参数均有效且符合要求:包括数据库引擎、版本、实例规格、字符集、网络配置、付费类型等。
2、恢复方式正确:根据选择的恢复方式(基于备份集恢复或基于时间点恢复),提供了必要的参数(如BackupSetId、RestoreTime、SourceRegion、SourceDBInstanceName)。
3、无冲突的资源配置:确保所选的可用区、交换机和IP地址等资源没有与其他实例冲突。
4、幂等性保证:ClientToken参数正确设置,确保请求的幂等性。
CheckCreateDrDBInstance接口是一个强大的工具,用于在创建新的RDS实例之前进行预检,确保所有配置都符合要求并能够成功执行跨地域恢复,通过仔细检查每个参数并解决可能的问题,可以大大提高恢复操作的成功率。
到此,以上就是小编对于“CheckCreateDdrDBInstance”的问题就介绍到这了,希望介绍的几点解答对大家有用,有任何问题和不懂的,欢迎各位朋友在评论区讨论,给我留言。
原创文章,作者:未希,如若转载,请注明出处:https://www.kdun.com/ask/1417790.html
本网站发布或转载的文章及图片均来自网络,其原创性以及文中表达的观点和判断不代表本网站。如有问题,请联系客服处理。
发表回复