创建数据库
功能介绍
在指定实例中创建数据库。
约束限制
该接口只支持单个数据库创建，实例在创建、变更规格、冻结、异常等状态下不能执行该操作。
调试
您可以在API Explorer中调试该接口。
URI
POST https://{
Endpoint
}/v3/{project_id}/instances/{instance_id}/database
表1 参数说明
名称
是否必选
说明
project_id
是
参数解释：
租户在某一Region下的项目ID。
获取方法请参见获取项目ID。
约束限制：
不涉及。
取值范围：
只能由英文字母、数字组成，且长度为32个字符。
默认取值：
不涉及。
instance_id
是
实例ID。
请求参数
表2 参数说明
名称
是否必选
参数类型
说明
name
是
String
数据库名称。
长度可在1～63个字符之间，由字母、数字、或下划线组成，不能包含其他特殊字符，不能以“pg”和数字开头，且不能和模板库重名。 模板库包括postgres， template0，template1，templatem。
character_set
否
String
数据库字符集。默认UTF8。
owner
否
String
数据库所属用户，缺省时默认是root，不能和系统用户重名，且必须是已存在的用户。
系统用户包括“rdsAdmin”,“ rdsMetric”, “rdsBackup”, “rdsRepl”。
template
否
String
数据库模板名称，支持template0。
lc_collate
否
String
数据库排序集。默认C。
须知：
不同的排序规则下，相同字符串的比较其结果可能是不同的。 例如，在en_US.utf8下， select 'a'>'A';执行结果为false，但在'C'下，select 'a'>'A';结果为true。如果数据库从“O”迁移到GaussDB，数据库排序集需使用'C'才能得到一致的预期。支持的排序规则可以查询系统表 pg_collation。
lc_ctype
否
String
数据库分类集。默认C。
响应参数
无。
请求示例
创建一个GaussDB数据库，库名为gaussdb_test。
POST https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/{instance_id}/database
{
"name" : "gaussdb_test",
"owner" : "test",
"template" : "template0",
"character_set" : "UTF8",
"lc_collate" : "en_US.UTF-8",
"lc_ctype" : "en_US.UTF-8"
}
响应示例
无。
状态码
-
正常
200
-
异常
请参见状态码。
错误码
请参见错误码。
