该接口用于授权普通账号访问PolarDB集群的某个数据库,一个账号可关联一个或多个数据库。

如果指定的账号对指定数据库已经具有访问权限,则会直接返回成功。

集群状态需要为运行中,否则操作将失败。

说明
  • 目前仅支持PolarDB MySQL。
  • 高权限账号默认拥有集群里所有数据库的权限,无需进行授权操作。

调试

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

请求参数

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

系统规定参数,取值:GrantAccountPrivilege

AccountName String testacc_01

账号名。

AccountPrivilege String ReadOnly

账号权限:

  • ReadWrite:读写。
  • ReadOnly:只读。
  • DMLOnly:只允许DML。
  • DDLOnly:只允许DDL。
说明 AccountPrivilege的个数需要与DBName保持一致,且顺序对应。例如,DBNametest1,test2AccountPrivilegeReadWrite,ReadOnly,则表示对指定账号对数据库test1授予读写权限,对数据库test2授予只读权限。
DBClusterId String pc-xxxxxxxxxxxxxxxx

集群ID。

DBName String testdb_1

设置要授权的数据库名。 支持同时对一个或多个数据库授权,多个数据库之间用英文(,)隔开。

返回数据

名称 类型 示例值 描述
RequestId String 2FED790E-FB61-4721-8C1C-07C627FA5A19

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=GrantAccountPrivilege
&AccountName=testacc_01
&AccountPrivilege=ReadOnly
&DBClusterId=pc-xxxxxxxxxxxxxxxx
&DBName=testdb_1
&<公共请求参数>

正常返回示例

XML 格式

<GrantAccountPrivilegeResponse>  
       <RequestId>2FED790E-FB61-4721-8C1C-07C627FA5A19</RequestId>
</GrantAccountPrivilegeResponse>

JSON 格式

{
   "RequestId": "2FED790E-FB61-4721-8C1C-07C627FA5A19"
}

错误码

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