You need to enable JavaScript to run this app.
导航
云数据库 SQL Server 版
  • 文档首页
    • /
  • 云数据库 SQL Server 版

CreateDBInstance

最近更新时间：2024.01.03 21:45:52

首次发布时间：2023.04.24 11:01:04

我的收藏

调用 CreateDBInstance 接口创建实例。

请求类型

异步请求。

请求参数

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

DBEngineVersion

String

是

SQLServer_2019_Std

兼容版本。取值如下：

  • SQLServer_2019_Std：表示 SQL Server 2019 标准版。

  • SQLServer_2019_Ent：表示 SQL Server 2019 企业版。

  • SQLServer_2019_Web：表示 SQL Server 2019 Web 版。

InstanceType

String

是

HA

实例类型。取值如下：

  • HA：表示高可用类型。

  • Basic：表示基础版类型。

  • Cluster：表示集群版类型。

说明

  • 在 DBEngineVersion 设置为 SQLServer_2019_Std 时，InstanceType 支持设置为 HA 或 Basic。

  • 在 DBEngineVersion 设置为 SQLServer_2019_Ent 时，InstanceType 支持设置为 Cluster 或 Basic。

  • 在 DBEngineVersion 设置为 SQLServer_2019_Web 时，InstanceType 支持设置为 Basic。

ZoneId

String

是

cn-beijing-a

节点所在可用区。在创建的实例包含主备节点，需要跨可用区部署主备节点时，您可以使用英文分号（;）隔开，默认第一个为主节点可用区，第二个为备节点可用区。

说明

您可以调用 DescribeAvailabilityZones 接口查询可用区。

NodeSpecString是rds.mssql.se.ha.d4.4c16g实例规格代码。更多关于实例规格代码的详细信息，请参见产品规格。
StorageSpaceInteger是100存储空间大小，单位为 GiB。取值范围：20GiB ~ 4000GiB，步长为 10GiB。

VpcId

String

是

VPC123456

私有网络（VPC） ID。

说明

您可以调用 DescribeVpcs 接口查询满足指定条件的私有网络。

SubnetId

String

是

Subnet123456

子网 ID。在跨可用区部署主备节点时，主备节点的子网也需设置为对应可用区私有网络下的子网，多个可用区需使用英文分号（;）隔开。

说明

您可以调用 DescribeSubnets 接口查询子网 ID。

SuperAccountPassword

String

是

Test@123456

高权限账号的密码。密码规则如下：

  • 长度为 8~32 个字符。

  • 由大写字母、小写字母、数字、特殊字符中的至少三种组成。特殊字符为 !@#$%^&*()_+-=。

DBTimeZoneString是China Standard Time时区。当前仅支持取值 China Standard Time。
ChargeInfoChargeInfoObject是{ "ChargeType": "PostPaid", "Number": 1 }付费方式。更多关于 ChargeInfo 信息，请参见 数据结构。

InstanceName

String

否

Name123

实例名称。实例名称的命名规则如下：

  • 不能以数字、中划线（-）开头。

  • 只能包含中文、字母、数字、下划线（_）和中划线（-）。

  • 长度限制在 1~128 之间。

Tags

Array of TagsObject

否

{
"Key":"key", "Value":"value"
}

实例标签。详细信息，请参见数据结构。

ServerCollationString否Chinese_PRC_CI_ASSQL Server 排序规则，当前仅支持 Chinese_PRC_CI_AS （默认值）取值。

ProjectName

String

否

default

所属项目，默认值为空。

说明

您可以调用 GetProject 接口查看项目信息。

返回参数

名称类型示例值描述
InstanceIdStringmssql-44171da8****实例 ID。
OrderIdStringOrder719479011897090****订单 ID。

请求示例

POST /?Action=CreateDBInstance&Version=2022-01-01 HTTP/1.1
Content-Type: application/json
Host: rds-mssql.volcengineapi.com
X-Date: 20230131T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mssql/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c6458****
{
    "DBEngineVersion":"SQLServer_2019_Std",
    "InstanceType":"HA",
    "ZoneId":"cn-beijing-a",
    "NodeSpec":"rds.mssql.se.ha.d4.4c16g",
    "StorageSpace":20,
    "VpcId":"vpc-2d5xeur6hiscg58ozfcuq****",
    "SubnetId":"subnet-2bzup883l93402dx0efe1****",
    "InstanceName":"实例样例",
    "SuperAccountPassword":"Admin@123",
    "ServerCollation":"Chinese_PRC_CI_AS",
    "Tags":[
        {
            "Key":"key1",
            "Value":"value1"
        },
        {
            "Key":"key2",
            "Value":"value2"
        }
    ],
    "DBTimeZone":"China Standard Time",
    "ProjectName":"default",
    "ChargeInfo":{
        "ChargeType":"PostPaid",
        "Number":1
    }
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202301312022404400C80FE28234E9F81D",
        "Action": "CreateDBInstance",
        "Version": "2022-01-01",
        "Service": "rds_mssql",
        "Region": "cn-beijing"
    },
    "Result": {
        "InstanceId": "mssql-44171da8****",
        "OrderId": "Order719479011897090****"
    }
}

错误码

更多详情，请参见错误码。