开发者社区 问答 正文

API参考 - API参考 -   账号管理 - CreateAccount



描述


该接口用于为数据库创建账号,同一个用户实例下,一个账号可以对多个数据库,同一账号对不同数据库权限可以不同。
实例和数据库必须满足以下条件,否则将创建失败:


  • 当前实例状态:运行中。

  • 当前数据库状态:运行中。

  • 当前实例没有被锁定。

  • 没有超出单个实例内的最大账号数量。


请求参数

[tr=rgb(51, 205, 229)][td]名称 类型是否必须描述ActionString是系统规定参数,取值为CreateAccount。DBInstanceIdString是实例名。AccountNameString是操作账号,必须唯一:
  • 以字母开头;
  • 由小写字母,数字、下划线组成;
  • 长度不超过16个字符。
  • 其他非法字符,见禁用关键字表
AccountPasswordString是操作密码,由字母、数字或下划线组成,长度为6~32位。AccountTypeString否取值为:
  • Normal:普通账号,默认为 Normal。
  • Super:超级账号
  • 该参数仅对 MySQL5.5/5.6、SQL Server 2008 R2 有效。
  • MySQL 5.7、SQL Server 2012/2016、PostgreSQL 和 PPAS 有且仅有一个初始账号,其他账号由初始账号连接数据库后创建。
AccountDescriptionString否账号备注:
  • 不能以http://和https://开头;
  • 以中文、英文字母开头;
  • 可以包含中文、英文字符、“_”、“-”和数字;
  • 长度为2~256字符。


返回参数

[tr=rgb(51, 205, 229)][td]参数 类型说明<公共返回参数>-详见公共参数

请求示例

https: //rds.aliyuncs.com/?Action=CreateAccount&AccountName=testacc02&AccountPassword=pw1234&DBInstanceId=riauvjz6zajfiq6ba1370329449201&<[公共请求参数]>

返回示例


XML格式< CreateAccountResponse>< RequestId>D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD</ RequestId></ CreateAccountResponse>
JSON格式{"RequestId": "D4D4BE8A-DD46-440A-BFCD-EE31DA81C9DD"}

展开
收起
梨好橙 2018-09-12 23:21:31 1682 分享 版权
阿里云 AI 助理回答

在阿里云RDS中创建数据库账号的接口主要用于为指定的数据库实例生成新的访问账号,允许用户通过该账号对关联的数据库进行操作。以下是创建账号时需遵循的关键条件和参数详情:

创建账号的前提条件:

  • 实例状态:确保目标RDS实例当前处于运行中状态。
  • 数据库状态:相关的数据库也应处于运行中状态。
  • 实例未锁定:实例没有被系统或人为锁定,以便进行账号管理操作。
  • 账号数量限制:未超过单个实例支持的最大账号数量限制。

请求参数详解:

  1. Action: String 类型,必须,固定值为CreateAccount,表示执行创建账号的操作。
  2. DBInstanceId: String 类型,必须,指定要创建账号的RDS实例ID。
  3. AccountName: String 类型,必须,新账号的名称。命名规则要求以字母开头,由小写字母、数字、下划线组成,长度不超过16字符,且需检查是否与已有账号名重复。
  4. AccountPassword: String 类型,必须,账号密码,需包含字母、数字或下划线,长度为6~32位,满足复杂度要求。
  5. AccountType: String 类型,可选,账号类型,默认为Normal(普通账号)。对于特定版本的MySQL和SQL Server,可设置为Super(超级账号),但请注意此参数的适用范围。
  6. AccountDescription: String 类型,可选,账号的描述信息,不能以http://https://开头,字符限制为2至256个,支持中文、英文、数字及特定符号(_、-)。

返回参数说明:

  • RequestId: 操作请求的唯一标识符,用于追踪操作状态。

示例请求格式(不包含URL编码及实际签名信息):

Action=CreateAccount
&DBInstanceId=your_instance_id
&AccountName=new_account_name
&AccountPassword=your_secure_password
&AccountType=Normal
&AccountDescription=Test Account Description

请根据实际情况替换示例中的your_instance_idnew_account_nameyour_secure_password等占位符内容,并注意调用API时遵循最新的接口规范和错误码定义,以确保操作成功。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答