调用CreateServerlessDBInstance接口创建云数据库MongoDB Serverless版实例。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateServerlessDBInstance

系统规定参数。取值:CreateServerlessDBInstance

RegionId String ap-southeast-1

地域ID,您可以调用DescribeRegions查询。

DBInstanceStorage Integer 1

实例存储空间。取值范围为1~100 GB,步长为1 GB。

ZoneId String ap-southeast-1c

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

Engine String MongoDB

数据库引擎,取值:MongoDB

EngineVersion String 4.2

数据库版本号,固定为4.2

DBInstanceDescription String 测试数据库1

实例名称,设置规则如下:

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

实例的IP白名单,以逗号隔开,不可重复,最多1000个IP。

说明
  • 支持格式:%,0.0.0.0/0,10.23.12.24(IP)或10.23.12.24/24(CIDR模式,无类域间路由,/24表示地址前缀的长度,范围为1~32)。
  • %和0.0.0.0/0表示任何IP地址都可以访问实例的数据库,属于高危设置,请谨慎设置。
AccountPassword String Alitest!159

数据库登录账号对应的密码。密码规则如下:

  • 由大写字母、小写字母、数字、特殊字符中的至少三种组成,特殊字符为!#$%^&*()_+-=
  • 长度为8~32位。
    说明 MongoDB Serverless实例提供一个默认的数据库登录账号,该账号无法被修改,您仅可以设置或修改该账号对应的密码。
Period Integer 1

实例的购买时长,单位为月。取值范围为:1~912243660

VpcId String vpc-bp175iuvg8nxqraf2****

专有网络(VPC)ID。

VSwitchId String vsw-bp1gzt31twhlo0sa5****

专有网络中的虚拟交换机ID。

ClientToken String ETnLKlblzczshOTUbOCz****

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

StorageEngine String WiredTiger

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

说明 关于存储引擎与版本的选择约束请参见版本与存储引擎
AutoRenew String true

设置实例是否自动续费,取值:

  • true:自动续费。
  • false:不自动续费,即需要手动续费。

    默认为false(手动续费)。

ResourceGroupId String rg-acfmyiu4ekp****

资源组ID。资源组详情请参见查看资源组基本信息

PeriodPriceType String Day

查询按天或按月的费用。取值:

  • Day:按天查询。
  • Month:按月查询。
CapacityUnit String 100

实例消耗的读写吞吐量。取值范围为100~8000 CU,步长为100 CU。

返回数据

名称 类型 示例值 描述
RequestId String 7A9807F0-1301-4154-9849-6497E94A****

请求ID。

DBInstanceId String dds-bp1hyjjqztj5****

实例ID。

OrderId String 21078214655****

订单ID。

示例

请求示例

http(s)://mongodb.aliyuncs.com/?Action=CreateServerlessDBInstance
&RegionId=ap-southeast-1
&DBInstanceStorage=1
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateServerlessDBInstanceResponse>
    <RequestId>7A9807F0-1301-4154-9849-6497E94A****</RequestId>
    <DBInstanceId>dds-bp1hyjjqztj5****</DBInstanceId>
    <OrderId>21078214655****</OrderId>
</CreateServerlessDBInstanceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "7A9807F0-1301-4154-9849-6497E94A****",
  "DBInstanceId" : "dds-bp1hyjjqztj5****",
  "OrderId" : "21078214655****"
}

错误码

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