You need to enable JavaScript to run this app.
导航
云数据库 MySQL 版
  • 文档首页
    • /
  • 云数据库 MySQL 版

ListAccounts

最近更新时间：2023.05.23 18:46:14

首次发布时间：2021.11.29 16:48:38

我的收藏

调用 ListAccounts 接口查询实例的账号信息。

请求类型

同步请求。

请求参数

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

InstanceId

String

是

mysql-603e30e6****

实例 ID。

说明

您可以调用 ListDBInstances 接口查询实例信息，包括实例 ID 。

AccountName

String

否

testuser1

数据库账号名称。

说明

您可以调用 ListDBInstances 接口查询数据库账号名称。

Offset

Integer

否

0

当前页查询偏移量，默认值为 0 。

说明

  • 若设置了该参数，Limit 也必填。
  • 若该参数留空，默认返回当前实例下已存在的所有信息。

Limit

Integer

否

10

每页记录数，取值：大于 0 且不超过 Integer 的最大值，默认值为 10。

说明

若设置了 Offset，该参数必填。

返回参数

名称类型示例值描述
TotalInteger1账号列表总数。

Datas

Array of AccountInfo

[
{
"AccountDesc": "这是一段账号 tester1 的描述。",
"AccountName": "testuser",
"AccountStatus": "Available",
"AccountType": "Normal",
"DBPrivileges": [
{
"DBName": "testdb",
"AccountPrivilege": "ReadOnly",
"AccountPrivilegeStr": "SELECT,LOCK TABLES,SHOW VIEW"
}
]
}
]

账号列表。关于 Accounts 的详细信息，请参见数据结构。

请求示例

POST /?Action=ListAccounts&Version=2018-01-01 HTTP/1.1
Content-Type: application/json
Host: rds.volcengineapi.com
X-Date: 20211202T101010Z
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20211202/cn-beijing/rds_mysql/request, SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645a****

{
    "InstanceId" : "mysql-603e30e6****",
    "Limit" : 1,
    "Offset" : 0
}

正常返回示例

{
    "ResponseMetadata" : {
        "RequestId": "d78bbf4e-63a5-4937-ac3c-3767e7eddfbe",
        "Action": "ListAccounts",
        "Version": "2018-01-01",
        "Service": "rds_mysql",
        "Region": "cn-beijing"
    },
 
    "Result": {
        "Total" : 10,
        "Datas":[
            {
                "AccountDesc": "这是一段账号 tester1 的描述。",
								"AccountName" : "testuser1",
                "AccountType" : "Normal",
                "AccountStatus" : "Available",
                "DBPrivileges" : [
                    "DBName" : "testdb1",
                    "AccountPrivilege" : "Custom",
                    "AccountPrivilegeStr" : "SELECT,LOCK TABLES,SHOW VIEW"
                ]
            }
        ]
    }
}

错误码

更多详情，请参见错误码。