调用DescribeAccounts接口查询AnalyticDB PostgreSQL版数据库的账号信息。

使用说明

本接口一般用于目标实例的初始账号的状态、描述以及所属实例。

QPS限制

本接口的单用户QPS限制默认为1000次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。

本文档中的QPS仅为默认参考值,准确信息请参见API速率配额列表

调试

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

请求参数

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

系统规定参数。取值:DescribeAccounts

DBInstanceId String gp-bp***************

实例ID。

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

数据库账号的名称。

返回数据

名称 类型 示例值 描述
RequestId String 7565770E-7C45-462D-BA4A-8A5396F2CAD1

请求ID。

Accounts Array of DBInstanceAccount

数据库账号的信息。

DBInstanceAccount
AccountStatus String 1

数据库账号的状态,取值说明:

  • 0:创建中。
  • 1:使用中。
  • 3:删除中。
AccountDescription String testuser

数据库账号的描述。

DBInstanceId String gp-bp***************

实例ID。

AccountName String testuser

数据库账号的名称。

示例

请求示例

http(s)://gpdb.aliyuncs.com/?Action=DescribeAccounts
&DBInstanceId=gp-xxxxxxxxx
&公共请求参数

正常返回示例

XML格式

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

<DescribeAccountsResponse>
    <RequestId>7565770E-7C45-462D-BA4A-8A5396F2CAD1</RequestId>
    <Accounts>
        <AccountStatus>1</AccountStatus>
        <AccountDescription>testuser</AccountDescription>
        <DBInstanceId>gp-bp***************</DBInstanceId>
        <AccountName>testuser</AccountName>
    </Accounts>
</DescribeAccountsResponse>

JSON格式

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

{
  "RequestId" : "7565770E-7C45-462D-BA4A-8A5396F2CAD1",
  "Accounts" : [ {
    "AccountStatus" : "1",
    "AccountDescription" : "testuser",
    "DBInstanceId" : "gp-bp***************",
    "AccountName" : "testuser"
  } ]
}

错误码

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