调用GrantAccountPrivilege接口授权账号访问数据库。

一个账号可授权访问一个或多个数据库。调用该接口时,请确保实例状态为运行中,否则将操作失败。

说明 该接口暂不支持SQL Server 2017集群版、PostgreSQL本地盘版。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String GrantAccountPrivilege

系统规定参数。取值:GrantAccountPrivilege

DBInstanceId String rm-uf6wjk5xxxxxxxxxx

实例ID。

AccountName String test1

账号名称。

DBName String testDB1,testDB2

需要授权访问的数据库名称,多个数据库名称之间用英文逗号(,)分隔。

AccountPrivilege String ReadWrite

账号权限,取值:

  • ReadWrite:读写
  • ReadOnly:只读
  • DDLOnly:仅执行DDL
  • DMLOnly:只执行DML
  • DBOwner:数据库所有者
说明
  • MySQL和MariaDB可传入ReadWriteReadOnlyDDLOnlyDMLOnly
  • SQL Server可传入ReadWriteReadOnlyDBOwner
  • PostgreSQL云盘版可传入DBOwner

返回数据

名称 类型 示例值 描述
RequestId String 81BC9559-7B22-4B7F-B705-5F56DEECDEA7

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=GrantAccountPrivilege
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&AccountName=test1
&DBName=testDB1,testDB2
&AccountPrivilege=ReadWrite
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<GrantAccountPrivilegeResponse>
	<RequestId>81BC9559-7B22-4B7F-B705-5F56DEECDEA7</RequestId>
</GrantAccountPrivilegeResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "81BC9559-7B22-4B7F-B705-5F56DEECDEA7"
}

错误码

HttpCode 错误码 错误信息 描述
400 Account.UpdateError Update Account failed, please check your input value 更新账户失败, 请检查请求参数,或实例参数策略配置
400 Database.ConnectError Database connect error. please check instance status and database processlist 数据库连接异常,请检查实例状态及数据库的连接池

访问错误中心查看更多错误码。