API参考—数据库管理—CreateDB-阿里云开发者社区

开发者社区> PolarDB-X开源社区> 正文
登录阅读全文

API参考—数据库管理—CreateDB

简介: 调用CreateDB接口创建数据库。

调试

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

调试

请求参数

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

系统规定参数。取值为CreateDB

AccountNameStringtest_acc

数据库所属的账号名称。

说明

  • 仅支持传入普通账号的账号名称,因为默认模式下的高权限账号默认拥有所有数据库的所有权限,而三权分立模式下的系统管理员账号、安全管理员账号和审计管理员账号均不需要该授权。
  • 您可以调用DescribeAccountList接口查看目标实例的账号信息,包括账号名称。
AccountPrivilegeStringReadWrite

数据库所属账号在目标数据库下的权限,取值范围如下:

  • ReadWrite:读写
  • ReadOnly:只读
  • DML:仅DML
  • DDL:仅DDL
  • ReadIndex:只读和索引
CharsetStringutf8

目标数据库所使用的编码字符集。

说明 您可以调用DescribeCharacterSet接口查询数据库支持的字符集类型。

DBInstanceNameStringpxc-****************

实例ID。

说明 您可以调用DescribeDBInstances接口查看目标地域下所有实例的详情,包括实例ID。

DbNameStringtest_db

新建数据库的名称。数据库名称需满足如下要求:

  • 由小写字母、数字、下划线(_)或中划线(-)组成,长度需为2~16个字符。
  • 需以字母开头,以字母或数字结尾。
  • 不能和已有的数据库名称重复。
RegionIdStringcn-hangzhou

实例所在地域ID。

说明 您可以调用DescribeRegions接口查看PolarDB-X支持的地域详情,包括地域ID。

DbDescriptionStringtest

数据库描述。最多支持256个字符。

SecurityAccountNameStringtest_dsa

安全管理员账号名称。

说明 若已开启三权分立模式,该参数必填。更多关于三权分立模式的信息,请参见三权分立

SecurityAccountPasswordStringPw@11111

安全管理员账号的密码。

说明 若已开启三权分立模式,该参数必填。更多关于三权分立模式的信息,请参见三权分立

返回数据

名称类型示例值描述
MessageString****

请求返回消息。

说明 请求成功时该参数为空,请求失败时会返回请求异常信息(如错误码等)。

RequestIdStringDC45C486-E7FA-409B-B002-9D16E4******

请求ID。

SuccessBooleantrue

请求是否成功。

示例

请求示例


http(s)://polardbx.cn-hangzhou.aliyuncs.com/?Action=CreateDB
&AccountName=test_acc
&AccountPrivilege=ReadWrite
&Charset=utf8
&DBInstanceName=pxc-****************
&DbName=test_db
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式


<code>200</code>
<data>
    <RequestId>DC45C486-E7FA-409B-B002-9D16E4******</RequestId>
    <Message/>
    <Success>true</Success>
</data>
<requestId>DC45C486-E7FA-409B-B002-9D16E4******</requestId>
<successResponse>true</successResponse>

JSON格式


{"RequestId":"DC45C486-E7FA-409B-B002-9D16E4******","Message":"****","Success":"true"}

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:

阿里云原生分布式数据库PolarDB-X,是一款面向超高并发、海量存储、复杂查询场景设计的云原生分布式数据库系统。其采用 Shared-nothing 与计算存储分离架构,支持水平扩展、分布式事务、混合负载等能力,具备企业级、云原生、高可用、高度兼容 MySQL 系统及生态等特点。

官方博客
最新文章
相关文章
官网链接