首页 云数据库 RDS 开发参考 API参考 API目录 实例 CreateDBInstanceForRebuild - 回收站重建实例

CreateDBInstanceForRebuild - 回收站重建实例

更新时间: 2023-09-26 14:16:22

该接口用于重建已进入回收站的实例。

接口说明

适用引擎

  • RDS MySQL
  • RDS PostgreSQL
  • RDS SQL Server
  • RDS MariaDB

相关功能文档

警告 该API操作涉及费用,请仔细阅读相关功能文档后再进行操作。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
rds:CreateDBInstanceForRebuildWrite
  • acs:rds:{#regionId}:{#accountId}:*

请求参数

名称类型必填描述示例值
RegionIdstring

地域ID。可调用DescribeRegions获取。

cn-hangzhou
DBInstanceIdstring

实例ID。可调用DescribeDBInstances获取。

rm-uf6wjk5****
PayTypestring

目标实例的付费类型,取值:

  • Postpaid:后付费(按量付费)
  • Prepaid:预付费(包年包月)
Postpaid
SecurityIPListstring

该实例的IP白名单。多条记录请以半角逗号(,)隔开,不可重复,最多1000条记录。支持如下两种格式:

  • IP地址形式,例如:10.10.XX.XX。
  • CIDR形式,例如:10.10.XX.XX/24(无类域间路由,24表示了地址中前缀的长度,范围为1~32)。

如不填则默认为原实例default分组白名单信息。

127.0.0.1
DBInstanceDescriptionstring

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

说明 不能以 http:// 和 https:// 开头。
testdb
ZoneIdstring

主节点可用区ID。可以通过接口DescribeRegions查看可用区ID。

说明 指定了VPC和交换机时,为匹配交换机对应的可用区,该参数必填。
cn-hangzhou-e
ZoneIdSlave1string

备可用区1。

说明 非基础版实例需要传入该参数。
cn-hangzhou-c
ZoneIdSlave2string

备可用区2。

说明 仅三节点企业版实例可传入该参数。
cn-hangzhou-d
VPCIdstring

目标实例的VPC ID。当InstanceNetworkType=VPC时,本参数必须配置。

说明 如果传入此参数,您还需要传入参数ZoneId
vpc-uf6f7l4fg90****
VSwitchIdstring

虚拟交换机ID。虚拟交换机所在的可用区必须和ZoneId中传入的可用区ID相对应。

说明
  • 网络类型InstanceNetworkType需为VPC
  • 若您填写了ZoneSlaveId1(备可用区ID),此处需填写两个交换机ID,并使用半角逗号(,)隔开。
  • vsw-uf6adz52c2p****
    Periodstring

    指定预付费实例为包年或者包月类型,取值:

    • Year:包年。
    • Month:包月。
    说明 若付费类型为Prepaid则该参数必须传入。
    Month
    UsedTimestring

    指定购买时长。取值:

    • 当参数PeriodYear时,UsedTime取值为1~5
    • 当参数PeriodMonth时,UsedTime取值为1~11
    说明 PayTypePrepaid,需要传入该参数。
    1
    ClientTokenstring

    该参数用于保证请求的幂等性,防止重复提交请求。参数值由客户端生成,保证在不同请求间唯一。

    该参数值由ASCII字符组成,最长不超过64个字符,不能包含非ASCII字符。

    ETnLKlblzczshOTUbOC****
    DBInstanceNetTypestring

    实例的网络连接类型,取值:

    • Internet:公网连接。
    • Intranet:内网连接。
    Internet
    InstanceNetworkTypestring

    目标实例的网络类型,取值:

    • VPC:VPC网络
    • Classic:经典网络

    默认创建经典网络类型的实例。

    说明 当本参数值为VPC时,还需要传入参数VpcIdVSwitchId
    VPC
    ResourceGroupIdstring

    资源组ID,可以为空。

    rg-acfmy****

    返回参数

    名称类型描述示例值
    object

    返回参数详情。

    RequestIdstring

    请求ID。

    1AD222E9-E606-4A42-BF6D-8A4442913CEF
    Messagestring

    返回信息。

    success
    DBInstanceIdstring

    实例ID。

    rm-uf6wjk5****
    TaskIdstring

    任务ID。

    417450000
    OrderIdstring

    订单ID。

    20793850608****

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
      "Message": "success",
      "DBInstanceId": "rm-uf6wjk5****",
      "TaskId": "417450000",
      "OrderId": "20793850608****"
    }

    错误码

    HTTP status code错误码错误信息描述
    400RR309We have detected a security risk with your payment method. Please proceed with verification via the link in your email or console message and re-submit your order after verification.我们检测到您的付款方式存在安全风险。请通过电子邮件或控制台消息中的链接继续验证,并在验证后重新提交订单。
    400GeneralIns.CreatingThe general instance is creating.目前有实例还在生产中,请稍等
    400InvalidZone.NotSupportedForStorageTypeThe specified zone is closed or invalid for Specified DBInstanceStorageType.指定的区域已关闭或对于指定的DBInstanceStorageType无效。
    400GeneralIns.MaintainingThe general instance is maintaining.有实例在迁移或维护中,请稍等
    400GeneralIns.SwitchingThe general instance is Switching.HA切换中,请稍等
    400InvalidEngine.VauleNotSupportedThe specified parameter "Engine" is not valid.数据库类型不正确。请选用以下几种数据库类型:MySQL/SQLServer/PostgreSQL/PPAS。
    400InvalidEngineVersion.ValueNotSupportedThe specified parameter "EngineVersion" is not valid.数据库版本验证失败。 数据库版本号取值范围: MySQL:5.5/5.6/5.7; SQLServer:2008r2/2012; PostgreSQL:9.4; PPAS:9.3。
    400InvalidDBinstanceClass.ValueNotSupportedThe specified parameter DBinstanceClass is invalid.指定的参数“实例规格”无效
    400InvalidDBInstanceStorage.ValueNotSupportedThe specified parameter "DBInstanceStorage" is not valid.实例存储设置无效。请重新设置存储。各引擎支持的存储范围如下:MySQL支持5至1000GB;SQLServer支持10至1000GB;PostgreSQL和PPAS支持5至2000GB。
    400InvalidDBInstanceDescription.MalformedThe specified parameter "DBInstanceDescription" is not valid.实例备注验证失败。格式要求:实例备注不能超过256个字节,不能以http:// , https://开头,必须以中文、英文字母开头。可以包含中文、英文字符、”_”,” -”,数字字符长度2~256。
    400InvalidSecurityIPList.DuplicateSpecified security IP list is not valid: Duplicate IP address in the list指定的安全IP列表无效。其中包含重复值。
    400InvalidSecurityIPListLength.MalformedThe quota of security ip exceeds.已超过安全IP数量上限。
    400DefaultVpc.NotSupportThe default vpc create is not support.操作失败,您的阿里云账号不支持默认VPC网络,请先创建VPC网络和交换机。
    400Forbidden.RegionNotFoundThe provided RegionId does not exist in our record.操作失败,当前提供的地域标识在记录中不存在。
    400InvalidVpcIdOrVswitchId.NotSupportedThe specified vpcId or vSwitchId is not supported.指定的vpcId或者vSwitchId不支持,请检查实例信息
    400InvalidVpcId.NotSupportedThe specified vpcId or vSwitchId is not supported.操作失败,VPC或交换机不正确。请检查VPC或交换机是否和RDS在同一可用区。
    400InvalidZoneId.NotSupportedThe Specified vpc Zone not supported.当前可用区不支持创建VPC网络类型实例,请更换可用区。
    400VswitchIpExhaustedNo available ip in the specified vswitch.指定的vswitch中没有可用的IP。
    400InvalidGeneralGroupName.MalformedThe specified parameter GeneralGroupName is not valid.参数 GeneralGroupName 不合法.
    400AccountBasicInfoUncompletedYour information is incomplete. Complete your information before the operation.您的信息不完整。在操作前完善您的信息。
    400IncorrecttVpcIdThe specified parameter VPCId is not valid.VPCId无效。请您选择正确的VPC网络。
    400OperationDenied.DBInstanceStatusOperation is denied by the current database instance status.操作失败,当前数据库实例状态不支持。
    400InvalidDBInstanceClass.OfflineThe specified instance type is no longer provided. Please specify another instance type.当前所选的实例规格已下线,请更换其他实例规格。
    403ClassicNetworkType.NotSupportThe Classic instance network create is not support.操作失败,当前实例不支持创建经典网络类型,请创建其他网络类型的实例。
    403InvalidEngineVersionInRegion.NotAvailableThe EngineVersion in the Region is not available.操作失败,当前地域不支持该引擎版本。
    403OperationDeniedThe specified request is out of resources.指定请求资源不足。
    403QuotaExceeded.CreateInstanceThe quota of create instance exceeds.已超过实例数量上限。请释放不需要的实例。
    403Forbidden.AuthenticationThe operation is forbidden by Aliyun Realname Authentication System.操作失败,该操作被阿里云实名认证系统禁止。
    403INST_HAS_UNPAID_ORDERThe instanceId has unpaid order.实例存在未支付订单,请先完成结算或作废订单后重试。
    403COMMODITY.FAILEDThe commodity is error.服务器异常,请提交运维同学处理。
    403MoneyLessThan100The Account Monet less Than 100.当前阿里云账号余额不足100,请充值。
    403OperationDenied.ClassicNetworkTypeThe operation is not permitted due to status of instance.操作失败,经典网络类型不支持此操作。
    404InvalidDBInstanceId.NotFoundInvalid DBInstanceId NotFound.实例不存在。请确认该实例是否在当前账号下。
    404CreateOrder.FailedCreate Order Failed.创建订单失败。
    404InvalidRegionId.NotFoundThe provided RegionId does not exist in our records.该地域不存在,请重新设置。
    404QueryPrice.FailedQueryPrice Failed.询价失败,请联系客服同学。

    访问错误中心查看更多错误码。

    变更历史

    变更时间变更内容概要操作
    2023-04-06OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403
      删除错误码:404
    2023-03-16OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      错误码 400 变更
      删除错误码:403
      删除错误码:404
    阿里云首页 云数据库 RDS 相关技术圈