调用DescribeAccounts接口查看实例的帐号信息。

说明 该接口暂不支持SQL Server 2017集群版、PostgreSQL、PPAS实例。

调试

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

请求参数

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

系统规定参数,取值:DescribeAccounts

DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。

AccountName String test1

数据库账号名称。

PageSize Integer 30

每页记录数。默认值:30

PageNumber Integer 1

页码,取值:大于0且不超过Integer的最大值。

默认值:1

返回数据

名称 类型 示例值 描述
RequestId String A2E94301-D07F-4457-9B49-6AA2BB388C85

请求ID。

SystemAdminAccountStatus String True

超级权限账号是否启用。

SystemAdminAccountFirstActivationTime String 2020-02-06T11:00:00Z

超级权限账号首次启用时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

说明 仅当SysadminAccount为True时返回,其余情况为空。
Accounts Array

账号信息列表。

DBInstanceId String rm-uf6wjk5xxxxxxx

账号所属实例ID。

AccountName String test1

数据库账号名称。

AccountStatus String Available

账号状态:

  • Unavailable:不可用
  • Available:可用
AccountType String Normal

账号类型,取值:

  • Normal:普通账号
  • Super:高权限账号
  • Sysadmin:具备超级权限(SA)的账号
AccountDescription String 测试数据库账号

账号描述。

PrivExceeded String 0

账号管理的数据库是否超过最大数量限制,取值:

  • 1:是
  • 0:否
DatabasePrivileges Array

账号拥有的数据库权限列表。

DBName String test1

数据库名称。

AccountPrivilege String ReadWrite

账号的权限类型,取值:

  • ReadWrite:读写
  • ReadOnly:只读
  • DDLOnly:仅DDL
  • DMLOnly:只DML
  • Custom:自定义(可以通过SQL命令修改)
AccountPrivilegeDetail String SELECT,INSERT

账号权限类型对应的具体权限。请参见账号权限列表

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeAccounts
&DBInstanceId=rm-uf6wjk5xxxxxxx
&<公共请求参数>

正常返回示例

XML 格式

<DescribeAccountsResponse>
	  <Accounts>
		    <DBInstanceAccount>
			      <DatabasePrivileges>
				        <DatabasePrivilege>
					          <AccountPrivilege>ReadWrite</AccountPrivilege>
					          <AccountPrivilegeDetail>SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,REFERENCES,INDEX,ALTER,CREATE TEMPORARY TABLES,LOCK TABLES,CREATE VIEW,SHOW VIEW,CREATE ROUTINE,ALTER ROUTINE,EXECUTE,EVENT,TRIGGER</AccountPrivilegeDetail>
					          <DBName>testdb</DBName>
				        </DatabasePrivilege>
			      </DatabasePrivileges>
			      <AccountStatus>Available</AccountStatus>
			      <AccountDescription></AccountDescription>
			      <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
			      <AccountName>testacc02</AccountName>
			      <PrivExceeded>0</PrivExceeded>
			      <AccountType>Normal</AccountType>
		    </DBInstanceAccount>
	  </Accounts>
	  <RequestId>A2E94301-D07F-4457-9B49-6AA2BB388C85</RequestId>
</DescribeAccountsResponse>

JSON 格式

{
    "Accounts": {
        "DBInstanceAccount": [
            {
                "DatabasePrivileges": {
                    "DatabasePrivilege": [
                        {
                            "AccountPrivilege": "ReadWrite",
                            "AccountPrivilegeDetail": "SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,REFERENCES,INDEX,ALTER,CREATE TEMPORARY TABLES,LOCK TABLES,CREATE VIEW,SHOW VIEW,CREATE ROUTINE,ALTER ROUTINE,EXECUTE,EVENT,TRIGGER",
                            "DBName": "testdb"
                        }
                    ]
                },
                "AccountStatus": "Available",
                "AccountDescription": "",
                "DBInstanceId": "rm-uf6wjk5xxxxxxx",
                "AccountName": "testacc02",
                "PrivExceeded": "0",
                "AccountType": "Normal"
            }
        ]
    },
    "RequestId": "A2E94301-D07F-4457-9B49-6AA2BB388C85"
}

错误码

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