云数据库 GAUSSDB-创建数据库实例(v5):请求参数

时间:2024-12-25 17:05:08

请求参数

表2 请求参数

名称

是否必选

参数类型

说明

name

String

实例名称。

用于表示实例的名称,同一租户下,同类型的实例名可重名。

取值范围:4~64个字符之间,必须以字母开头,区分大小写,可以包含字母、数字、中划线或者下划线,不能包含其他的特殊字符。

datastore

Object

数据库信息。

详情请参见表3

ha

Object

实例部署形态。详情请参见表4

configuration_id

String

参数模板ID。当不传该参数时,使用系统默认的参数模板,且响应体中不返回该参数。

port

String

数据库对外开放的端口,不填默认为8000,可选范围为:1024-39998。限制端口: 2378,2379,2380,4999,5000,5999,6000,6001,8097,8098,12016,12017,20049,20050,21731,21732,32122,32123,32124。

password

String

数据库密码。

GaussDB 密码取值范围:

非空; 至少包含大写字母(A-Z),小写字母(a-z),数字(0-9),非字母数字字符(限定为~!@#%^*-_=+?,)四类字符中的三类字符;长度8~32个字符。

建议您输入高强度密码,以提高安全性,防止出现密码被暴力破解等安全风险。

backup_strategy

Object

备份策略。

详情请参见表5

enterprise_project_id

String

企业项目ID。只有企业租户时该参数才生效。

使用请参考《企业管理 API参考》的“查询企业项目列表”响应消息表“enterprise_project字段数据结构说明”的“id”。

disk_encryption_id

String

用于磁盘加密的密钥ID,默认为空。

密钥授权请参考《 数据加密 服务 用户指南》的“创建授权”章节。

flavor_ref

String

规格码,取值范围:非空。参考查询数据库规格中“spec_code”字段获取。

volume

Object

volume信息。

详情请参见表6

region

String

区域ID。

取值范围:非空,请参见地区和终端节点

availability_zone

String

可用区ID。

GaussDB取值范围:非空,可选部署在相同可用区或不同可用区,可用区之间用逗号隔开。

取值范围:非空,请参见地区和终端节点

vpc_id

String

虚拟私有云ID,获取方法如下:

  • 方法1:登录虚拟私有云服务的控制台界面,在虚拟私有云的详情页面查找VPC ID。
  • 方法2:通过虚拟私有云服务的API接口查询,具体操作可参考查询VPC列表

subnet_id

String

子网的网络ID信息,获取方法如下:

  • 方法1:登录虚拟私有云服务的控制台界面,单击VPC下的子网,进入子网详情页面,查找网络ID。
  • 方法2:通过虚拟私有云服务的API接口查询,具体操作可参考查询子网列表

security_group_id

String

指定实例所属的安全组。如果不需要指定安全组,请联系客服申请白名单。

  • 方法1:登录虚拟私有云服务的控制台界面,在安全组的详情页面查找安全组ID。
  • 方法2:通过虚拟私有云服务的API接口查询,具体操作可参考查询安全组列表

charge_info

Object

计费类型信息,仅支持按需和包周期。

详情请参见表7

time_zone

String

UTC时区。

  • 不选择时,GaussDB国内站默认为UTC时间。
  • 选择填写时,取值范围为UTC-12:00~UTC+12:00,且只支持整段时间,如UTC+08:00,不支持UTC+08:30。

sharding_num

Integer

仅分布式形态需要填写该参数。分片数量,取值范围1~9。

coordinator_num

Integer

仅分布式形态需要填写该参数。协调节点数量,取值范围1~9。CN数量必须小于或等于两倍的分片数。

replica_num

Integer

实例副本集数,支持取值3。不填默认为3。

enable_force_switch

Boolean

enable_force_switch表示是否开启备机强升主功能,仅支持取值true,false。true表示开启备机强升主功能,false表示关闭,默认关闭。仅支持1.2.2及以上版本。

说明:

备机强升主功能适用场景:在主机发生故障后,为了保障集群的可用性,强制拉起备机作为新主机对外提供服务。本功能在集群故障状态下,以丢失部分数据为代价换取集群尽可能快的恢复服务,是集群状态为不可用时的一个逃生方法。

enable_single_float_ip

Boolean

单浮动IP策略,仅主备版支持。默认值是false,表示不开启单浮动IP策略。

取值范围:

  • true:开启单浮动IP策略,实例将只有一个浮动IP绑定主节点,如果发生主备倒换,浮动IP不会发生变化。
  • false:不开启单浮动IP策略,每个节点都会绑定一个浮动IP,如果发生主备倒换,浮动IP会发生变化。
    说明:

    仅支持3.206及以上版本的主备版实例。

表3 datastore字段数据结构说明

名称

是否必选

参数类型

说明

type

String

数据库引擎,取值如下:

GaussDB。不区分大小写。

version

String

数据库版本。不填时,默认为当前最新版本。

GaussDB支持的版本参考查询数据库引擎的版本查询。

表4 ha字段数据结构说明

名称

是否必选

参数类型

说明

mode

String

GaussDB为分布式模式取值:enterprise(企业版) ,combined(基础版混合部署),主备版取值:centralization_standard,不区分大小写。

consistency

String

指定事务一致性类型,取值如下,不区分大小写:

  • strong:强一致性。
  • eventual:最终一致性。

replication_mode

String

备机同步模式。固定取值为sync,表示数据同步方式为“同步模式”。

instance_mode

String

指定创建实例的产品类型。不传该参数默认创建企业版实例,创建基础版和生态版需要指定参数值。

  • enterprise:创建企业版实例。
  • basic:创建基础版实例。
  • ecology:创建生态版实例。
表5 backup_strategy字段数据结构说明

名称

是否必选

参数类型

说明

start_time

String

备份时间段。自动备份将在该时间段内触发。

取值范围:非空且非负,格式必须为hh:mm-HH:MM且有效,当前时间指UTC时间。

  • HH取值必须比hh大1。
  • mm和MM取值必须相同,且取值必须为00。

取值示例:

  • 08:00-09:00
  • 23:00-00:00

keep_days

Integer

指定备份文件的可保存天数。

取值范围: 1~36500。该参数缺省时,默认填写为7天。

表6 volume字段数据结构说明

名称

是否必选

参数类型

说明

type

String

磁盘类型。

  • 仅支持ULTRAHIGH和ESSD,区分大小写,分别表示SSD和极速云盘。

size

Integer

磁盘大小。例如:该参数填写为“40”,表示为创建的实例分配40GB的磁盘空间。

E CS 部署方案:取值范围:(分片数*40GB)~(分片数*24TB),且大小只能为分片数*4GB的整数倍。

表7 chargeInfo字段数据结构说明

名称

是否必选

参数类型

说明

charge_mode

String

计费模式。

postPaid:后付费,即按需付费。

prePaid:预付费,即包年/包月。

period_type

String

订购周期类型。

取值范围:

  • month:包月。
  • year:包年。
    说明:

    “charge_mode”“prePaid”时生效,且为必选值。

period_num

Integer

“charge_mode”“prePaid”时生效,且为必选值,指定订购的时间。

取值范围:

  • “period_type”“month”时,取值为1~9。
  • “period_type”“year”时,取值为1~3。

当传入浮点型时,会自动截取为整型。

is_auto_renew

Boolean

创建包周期实例时可指定,表示是否自动续订,续订时会自动支付。 按月订购时续订周期默认为1个月,按年订购时续订周期默认为1年,续订周期可自定义修改。

  • true,为自动续订。
  • false,为不自动续订,默认该方式。

is_auto_pay

Boolean

创建包周期时可指定,表示是否自动从客户的账户中支付,此字段不影响自动续订的支付方式。

  • true,为自动支付。
  • false,为手动支付,默认该方式。
support.huaweicloud.com/api-gaussdb/gaussdb_api_356.html