文档

CreateDBInstance - 创建或克隆副本集实例

创建或克隆云数据库MongoDB版副本集实例。

接口说明

请确保在使用该接口前,已充分了解云数据库 MongoDB 产品的收费方式和价格

关于云数据库 MongoDB 实例的规格,请参见实例规格表

如需创建分片集群实例,您可以通过调用 CreateShardingDBInstance 接口进行创建。

调试

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

授权信息

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

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

请求参数

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

地域 ID,您可以通过调用 DescribeRegions 接口查询地域 ID。

说明 调用本接口克隆实例或者回收站恢复实例时,该参数值需和源实例保持一致。
cn-hangzhou
ClientTokenstring

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

ETnLKlblzczshOTUbOCz****
ZoneIdstring

可用区 ID,您可以通过调用 DescribeRegions 接口查询可用区 ID。

cn-hangzhou-g
Enginestring

数据库引擎,固定取值:MongoDB

MongoDB
EngineVersionstring

数据库版本号,取值:

  • 7.0
  • 6.0
  • 5.0
  • 4.4
  • 4.2
  • 4.0
说明 调用本接口克隆实例或者回收站恢复实例时,该参数值需和源实例保持一致。
4.4
DBInstanceClassstring

实例规格,您可以通过调用 DescribeAvailableResource 接口查询实例规格。

dds.mongo.standard
DBInstanceStorageinteger

实例存储空间,单位:GB。

具体取值受实例规格约束,详情请参见副本集实例规格表

10
DBInstanceDescriptionstring

实例名称,取值说明:

  • 以中文、英文字母开头。
  • 可以包含数字、中文、英文、下划线(_)和短横线(-)。
  • 长度为 2~256 个字符。
test
SecurityIPListstring

实例的 IP 白名单,多个 IP 地址请用英文逗号(,)分隔,不可重复。支持如下三种格式:

  • 0.0.0.0/0
  • IP 地址形式,例如:10.23.12.24。
  • CIDR 形式,例如:10.23.12.0/24(无类域间路由,24 表示了地址中前缀的长度,范围为 1~32)。
说明
  • 每个实例最多添加 1000 个 IP 或 IP 段,即所有 IP 白名单分组内的 IP 或 IP 段总和不能超过 1000。
  • 0.0.0.0/0 表示任何 IP 地址都可以访问实例的数据库,属于高危设置,请谨慎设置。
  • 192.168.xx.xx,192.168.xx.xx
    AccountPasswordstring

    root 账号的密码,取值说明:

    • 由大写字母、小写字母、数字和特殊字符中的至少三种组成。
    • !#$%^&*()_+-=为特殊字符。
    • 长度为 8~32 个字符。
    123456Aa
    ChargeTypestring

    实例的付费类型,取值说明:

    • PostPaid:默认值,后付费(按量付费)。
    • PrePaid:预付费(包年包月)。
    说明 当该参数的值为 PrePaid 时,您还需要配置 Period 参数。
    PrePaid
    Periodinteger

    实例的购买时长,单位为月。

    取值范围:1~9(整数)、12243660

    说明 ChargeType 参数值为 PrePaid 时,该参数可用且为必填参数。
    1
    NetworkTypestring

    实例的网络类型,取值说明:

    VPC:专有网络。

    VPC
    VpcIdstring

    专有网络(VPC)ID。

    vpc-bp175iuvg8nxqraf2****
    VSwitchIdstring

    虚拟交换机 ID。

    vsw-bp1gzt31twhlo0sa5****
    SrcDBInstanceIdstring

    源实例 ID。

    说明 调用本接口克隆实例时,您需要配置该参数,同时还需要配置 BackupIdRestoreTime 参数。调用本接口进行回收站恢复时,只需要传入该参数,无需配置 BackupIdRestoreTime
    dds-bp1ee12ad351****
    BackupIdstring

    备份点 ID,您可以通过调用 DescribeBackups 接口查询备份点 ID。

    说明 只有调用本接口按备份点克隆实例时,您需要配置该参数,同时还需要配置 SrcDBInstanceId 参数。
    32994****
    RestoreTimestring

    选择要恢复的时间点,您可以配置 7 天内的任意时间点。格式为yyyy-MM-ddTHH:mm:ssZ(UTC 时间)。

    说明 只有调用本接口按时间点克隆实例时,您需要配置该参数,同时还需要配置 SrcDBInstanceId 参数。
    2022-03-13T12:11:14Z
    BusinessInfostring

    附加参数,业务信息。

    {“ActivityId":"000000000"}
    AutoRenewstring

    实例是否自动续费,取值说明:

    • true:自动续费。
    • false:默认值,不自动续费,即手动续费。
    说明 ChargeType 参数值为 PrePaid 时,该参数可用且为可选参数。
    true
    DatabaseNamesstring

    数据库名。

    说明 调用本接口克隆实例时,您可以通过配置该参数指定需要克隆的数据库,如果不配置该参数,则克隆实例的所有数据库。
    mongodbtest
    CouponNostring

    是否使用优惠券,取值说明:

    • defaultnull(默认):使用优惠券。
    • youhuiquan_promotion_option_id_for_blank:不使用优惠券。
    default
    StorageEnginestring

    实例的存储引擎,取值固定为 WiredTiger

    说明
  • 调用本接口克隆实例或回收站恢复实例时,该参数需和源实例保持一致。
  • 关于存储引擎与版本的选择约束,请参见版本与存储引擎
  • WiredTiger
    ReplicationFactorstring

    副本集实例的主备节点数,取值:

    • 3(默认值)
    • 5
    • 7
    3
    ReadonlyReplicasstring

    副本集实例的只读节点数,取值范围:0~5(整数),默认值为 0

    0
    ResourceGroupIdstring

    资源组 ID。

    rg-acfmyiu4ekp****
    ClusterIdstring

    专属集群 ID。

    dhg-2x78****
    StorageTypestring

    存储类型,取值说明:

    • cloud_essd1:ESSD PL1 云盘。
    • cloud_essd2:ESSD PL2 云盘。
    • cloud_essd3:ESSD PL3 云盘。
    • cloud_auto:ESSD AutoPL 云盘。
    • local_ssd:SSD 本地盘。
    说明 ESSD AutoPL 云盘目前仅支持中国站。
    cloud_essd1
    SecondaryZoneIdstring

    配置从节点(Secondary 节点)所在的可用区,实现多可用区部署。取值说明:

    • cn-hangzhou-g:杭州可用区 G。
    • cn-hangzhou-h:杭州可用区 H。
    • cn-hangzhou-i:杭州可用区 I。
    • cn-hongkong-b:中国香港可用区 B。
    • cn-hongkong-c:中国香港可用区 C。
    • cn-hongkong-d:中国香港可用区 D。
    • cn-wulanchabu-a:乌兰察布可用区 A。
    • cn-wulanchabu-b:乌兰察布可用区 B。
    • cn-wulanchabu-c:乌兰察布可用区 C。
    • ap-southeast-1a:新加坡可用区 A。
    • ap-southeast-1b:新加坡可用区 B。
    • ap-southeast-1c:新加坡可用区 C。
    • ap-southeast-5a:雅加达可用区 A。
    • ap-southeast-5b:雅加达可用区 B。
    • ap-southeast-5c:雅加达可用区 C。
    • eu-central-1a:法兰克福可用区 A。
    • eu-central-1b:法兰克福可用区 B。
    • eu-central-1c:法兰克福可用区 C。
    说明
  • EngineVersion 参数值为4.45.0时,该参数可用且为必填参数。
  • 该参数取值不能与 ZoneIdHiddenZoneId 参数值相同。
  • cn-hangzhou-h
    HiddenZoneIdstring

    配置隐藏节点(Hidden 节点)所在的可用区,实现多可用区部署。取值说明:

    • cn-hangzhou-g:杭州可用区 G。
    • cn-hangzhou-h:杭州可用区 H。
    • cn-hangzhou-i:杭州可用区 I。
    • cn-hongkong-b:中国香港可用区 B。
    • cn-hongkong-c:中国香港可用区 C。
    • cn-hongkong-d:中国香港可用区 D。
    • cn-wulanchabu-a:乌兰察布可用区 A。
    • cn-wulanchabu-b:乌兰察布可用区 B。
    • cn-wulanchabu-c:乌兰察布可用区 C。
    • ap-southeast-1a:新加坡可用区 A。
    • ap-southeast-1b:新加坡可用区 B。
    • ap-southeast-1c:新加坡可用区 C。
    • ap-southeast-5a:雅加达可用区 A。
    • ap-southeast-5b:雅加达可用区 B。
    • ap-southeast-5c:雅加达可用区 C。
    • eu-central-1a:法兰克福可用区 A。
    • eu-central-1b:法兰克福可用区 B。
    • eu-central-1c:法兰克福可用区 C。
    说明
  • EngineVersion 参数值为4.45.0时,该参数可用且为必填参数。
  • 该参数值不能与 ZoneIdSecondaryZoneId 参数值相同。
  • cn-hangzhou-i
    Tagobject []

    用户自定义标签。

    Keystring

    标签的键。

    说明
  • N 表示传入第几个标签的键。例如:Tag.1.Key表示传入第一个标签的键;Tag.2.Key表示传入第二个标签的键。
  • testdatabase
    Valuestring

    标签的值。

    说明 N 表示传入第几个标签的值。例如:Tag.1.Value表示传入第一个标签的值;Tag.2.Value表示传入第二个标签的值。
    apitest
    GlobalSecurityGroupIdsstring

    实例的全局 IP 白名单模板,多个 IP 白名单模板请用英文逗号(,)分隔,不可重复。(功能灰度中)

    g-qxieqf40xjst1ngpr3jz
    Encryptedboolean

    是否开启云盘加密

    true
    EncryptionKeystring

    自定义密钥 ID。

    2axxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
    ProvisionedIopslong

    预配置性能(IOPS)。取值范围为 0~50000。

    1960

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    请求 ID。

    D8F1D721-6439-4257-A89C-F1E8E9C9****
    DBInstanceIdstring

    实例 ID。

    dds-bp144a7f2db8****
    OrderIdstring

    订单 ID。

    21077576248****

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "D8F1D721-6439-4257-A89C-F1E8E9C9****",
      "DBInstanceId": "dds-bp144a7f2db8****",
      "OrderId": "21077576248****"
    }

    错误码

    HTTP status code错误码错误信息描述
    400SecurityRisk.AuthVerificationwe have detected a risk with your default payment method. An email and notification has been sent to you. Please re-submit your order before after verificaiton.-
    400MissingParameterPeriod is mandatory for this action.-
    400ORDER.ACCOUNT_INFORMATION_INCOMPLETEYour information is incomplete. Complete your information before ordering.-
    400InvalidClientToken.MalformedSpecified parameter ClientToken is not valid.-
    400InvalidDBInstanceDescription.MalformedSpecified parameter DBInstanceDescription is not valid.节点名称不合法
    400InvalidSecurityIPListLength.MalformedThe quota of security ip exceeds.-
    400InsufficientBalanceYour account does not have enough balance.支付失败,您可以添加其他支付方式,也可以充值后重试。
    400QuotaExceed.AfterpayInstanceLiving afterpay instances quota exceeded.-
    400InvalidCapacity.NotFoundThe Capacity provided does not exist in our records.实例的存储容量配置错误,请设置为有效范围内的值,单位为MB。
    400ResourceNotAvailableResource you requested is not available for finance user.-
    400IdempotentParameterMismatchRequest uses a client token in a previous request but is not identical to that request.ClientToken参数值已被使用,请输入未使用过的ClientToken参数值。ClientToken由客户端生成,需保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。
    400InvalidSecurityIPList.MalformedThe specified parameter "SecurityIPList" is not valid.-
    400InvalidSecurityIPList.DuplicateThe Security IP address is not in the available range or occupied.-
    400InvalidSecurityIPListLength.MalformedThe quota of security ip exceeds.-
    400InvalidDBInstanceStorage.ValueNotSupportedThe specified parameter DBInstanceStorage is not valid.-
    400InvalidAccountPassword.MalformedSpecified parameter AccountPassword is not valid.-
    400TokenServiceErrorDuplicate ClientToken request.-
    400Zone.ClosedThe specified zone is closed.-
    400PRICE.ORIGIN_PRICE_ERRORThe origin price error.-
    400NO_AVAILABLE_PAYMENT_METHODNo payment method is specified for your account. We recommend that you add a payment method.-
    400InvalidEcsImage.NotFoundSpecified ecs image does not exist.-
    400SaleValidateNoSpecificCodeFailedSpecified Storage or Version or InstanceClass is invalid.-
    400Trade_Not_Support_Async_PayTrade not support async pay.-
    403RealNameAuthenticationErrorYour account has not passed the real-name authentication yet.阿里云账号未进行实名认证,请进行实名认证后重试。
    403RegionUnauthorizedThere is no authority to create instance in the specified region.-
    403OperationDeniedThe resource is out of usage.-
    403InvalidEngineVersionInRegion.NotAvailableThe EngineVersion in the Region is not available.-
    403InvalidBackupLogStatusCurrent backup log enable status does not support this operation.-
    403IncorrectBackupSetStateCurrent backup set state does not support operations.当前最新备份集未就绪,请稍后重试。
    404InvalidBackup.NotFoundThe available backup does not exist in recovery time.-

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

    变更历史

    变更时间变更内容概要操作
    2024-03-13OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403
      删除错误码:404
    2024-01-12OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403
      删除错误码:404
    2023-11-03OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403
      删除错误码:404
    2023-08-24OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403
      删除错误码:404
    入参OpenAPI 入参发生变更
      新增入参:ProvisionedIops
    2023-08-01OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403
      删除错误码:404
    入参OpenAPI 入参发生变更
      新增入参:Tag
    2023-06-05OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:403
      删除错误码:404
    入参OpenAPI 入参发生变更
      新增入参:Encrypted
      新增入参:EncryptionKey
    • 本页导读 (1)
    文档反馈