调用 CreateDBInstance 接口创建 veDB MySQL 实例。
异步请求。
自 2022 年 05 月 17 日起,新开通 veDB MySQL 产品的客户和存量实例都需要进行跨服务访问授权。跨服务访问授权方法如下:
ServiceName
为 vedbm
)接口完成跨服务授权。注意
您需尽快完成授权,否则在调用 CreateDBInstance 接口时将会报错。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
InstanceName | String | 否 | test | 实例名称。命名规则:
说明
|
DBEngineVersion | String | 是 | MySQL_8_0 | 实例兼容版本。取值范围:
|
DBMinorVersion | String | 否 | 3.0 | 根据兼容版本,选择 veDB MySQL 小版本,关于版本号的详细说明请参见版本号管理。
说明
|
NodeSpec | String | 是 | vedb.mysql.x4.xlarge | 实例的节点规格代码。 说明 关于实例节点规格的详细信息,请参见产品规格。 |
ZoneIds | String | 是 | cn-beijing-b | 可用区 ID。 说明 可调用 DescribeAvailabilityZones 接口查询 veDB MySQL 实例支持的可用区资源。 |
NodeNumber | Integer | 是 | 2 | 实例节点数量。取值范围为 2~16 个。 |
VpcId | String | 是 | vpc-3ajzohyfaru9s340jz1rp**** | 私有网络(VPC) ID。 说明 您可以调用 DescribeVpcs 接口查询要创建实例的 VPC ID。 |
SubnetId | String | 是 | subnet-1g15j13jtzgu88ibuxwqp**** | 子网 ID。子网必须属于所选的可用区。 说明
|
Port | Integer | 否 | 3306 | 为实例默认创建的连接终端指定私网端口号。默认取值为 3306,取值范围为 1000~65534。 说明
|
SuperAccountName | String | 否 | vedbuser | 高权限用户的账号名称。账号名称需满足以下要求:
说明 您可以在实例创建成功后,调用 CreateDBAccount 接口为实例创建高权限账号或普通账户。 |
SuperAccountPassword | String | 否 | kira**** | 高权限账号的密码。账号密码需满足以下要求:
|
DBTimeZone | String | 否 | UTC +08:00 | 实例的时区。国内所有地域默认时区为 UTC +08:00。 |
LowerCaseTableNames | String | 否 | 1 | 表名是否区分大小写,默认取值为 1。
说明 创建实例后不支持修改此规则,请根据业务需求合理设置。 |
ProjectName | String | 否 | default | 实例所属的项目名称,当该参数留空时,新建的实例默认加入 说明 项目是一个虚拟的概念,包括一组资源、用户和角色。通过项目可以对一组资源进行统一的查看和管理,并且控制项目内用户和角色管理这些资源的权限。更多详情,请参见资源管理。 |
Tags | Array of TagObject | 否 | 请参见请求示例。 | 需要绑定的标签键和标签值数组对象。关于 Tags 的更多详情,请参见 TagObject。 说明
|
DeletionProtection | String | 否 | disabled | 开启或关闭实例删除保护功能,取值范围:
说明 开启后,将无法删除该实例。如需删除实例,您需要先调用 ModifyDBInstanceDeletionProtectionPolicy 接口关闭该功能。关于删除保护的更多信息,请参见实例删除保护。 |
ChargeType | String | 是 | PostPaid | 计算计费类型。创建实例时计算计费类型可取值如下:
|
StorageChargeType | String | 否 | PostPaid | 存储计费类型。不传入该参数时,存储计费类型默认与计算计费类型取值一致,取值如下:
注意
|
AutoRenew | Boolean | 否 | false | 预付费场景下是否自动续费。取值:
说明 当 |
PeriodUnit | String | 否 | Month | 预付费场景下的购买周期。
说明 当 |
Period | Integer | 否 | 1 | 预付费场景下的购买时长。 说明 当 |
PrePaidStorageInGB | Integer | 否 | 50 | 预付费场景下的存储空间大小。 说明 当 |
Number | Integer | 否 | 1 | 创建的实例数量,取值范围 1~50,默认值为 1 。 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
InstanceId | String | vedbm-d4mx2akm**** | 实例 ID。 |
OrderId | String | Order707643373078888**** | 订单 ID。 |
POST /?Action=CreateDBInstance&Version=2022-01-01 HTTP/1.1 Content-Type: application/json Host: vedbm.volcengineapi.com X-Date: 20220101T101010Z Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/vedbm/request,SignedHeaders=x-date, Signature=6a593bf5f59e7c1109fb205c739d1cff4c672fe2d251963f4d48c8701d16**** { "DBEngineVersion":"MySQL_8_0", "ZoneIds":"cn-beijing-b", "NodeSpec":"vedb.mysql.x4.xlarge", "NodeNumber":2, "VpcId":"vpc-3ajzohyfaru9s340jz1rp****", "SubnetId":"subnet-1g15j13jtzgu88ibuxwqp****", "InstanceName":"test", "SuperAccountName":"vedbuser", "SuperAccountPassword":"Kira****", "DBTimeZone":"UTC +08:00", "Tags":[ { "Key":"chargetype", "Value":"postpaid" } ], "ChargeType":"PostPaid" }
正常返回示例
{ "ResponseMetadata": { "RequestId": "202204102136280102090801470751****", "Action": "CreateDBInstance", "Version": "2022-01-01", "Service": "vedbm", "Region": "cn-beijing" }, "Result": { "InstanceId": "vedbm-d4mx2akm****", "OrderId": "Order707643373078888****" } }
更多详情,请参见错误码。