文档中心

云数据库服务RDB API参考手册

最近更新时间：2023-04-16 17:00:00

5 账号相关接口

5.1 创建数据库账号

创建数据库账号。

5.1.1 使用描述

Content-Type: application/json
POST https://{Endpoint}/rdb/v1.0/createAccount

5.1.2 请求参数

表5-1 Body 中的请求参数

5.1.3 返回数据

5.1.4 示例

1. 请求示例
POST https://{Endpoint}/rdb/v1.0/createAccount
{
      "InstanceId": "mysql-d8b640278c19",
    "Engine": "MySQL",
    "AccountName": "test_account",
      "AccountPassword": "U3LN2pJtW6ZU5tZbnll8NA4Q3P7bnPnDpw==",
      "AccountDescription": "测试账号"
}
2. 正常返回示例
HTTP/1.1 200 OK
Content-Type:application/json
{
     "RequestId": "3C5CFDEE-F774-4DED-89A2-1D76EC63C575"
}

5.2 查询数据库账号列表

获取数据库账号列表。

5.2.1 使用描述

GET https://{Endpoint}/rdb/v1.0/describeAccounts

5.2.2 请求参数

表5-2 Query 中的请求参数

5.2.3 返回数据

表5-3 AccountVO 数据结构

表5-4 PrivilegeVO 数据结构

5.2.4 示例

1. 请求示例
GET
https://{Endpoint}/rdb/v1.0/describeAccounts?PageNumber=1&PageSize=10&InstanceId=mysql�d8b640278c19&Engine=MySQL
2. 正常返回示例
HTTP/1.1 200 OK
Content-Type:application/json
{
    "RequestId": "1661436496191",
    "TotalCount": 1,
    "PageNumber": 1,
      "PageSize": 10,
      "Items": [
    {
          "InstanceId": "mysql-d8b640278c19",
          "AccountName": "test_account",
          "AccountDescription": "测试账号",
          "Privileges": [
          {
              "DBName": "test_db",
              "Privilege": "DDL"
          }
          ]
      }
      ]
}

5.3 删除数据库账号

删除数据库账号。

5.3.1 使用描述

Content-Type: application/json
DELETE https://{Endpoint}/rdb/v1.0/deleteAccount

5.3.2 请求参数

表5-5 Body 中的请求参数

5.3.3 返回数据

5.3.4 示例

1. 请求示例
DELETE https://{Endpoint}/rdb/v1.0/deleteAccount
{
    "InstanceId": "mysql-d8b640278c19",
    "Engine": "MySQL",
    "AccountName": "test_account"
}
2. 正常返回示例
HTTP/1.1 200 OK
Content-Type:application/json
{
     "RequestId": "3C5CFDEE-F774-4DED-89A2-1D76EC63C575"
}

5.4 重置数据库账号密码

重置数据库账号密码。

5.4.1 使用描述

Content-Type: application/json
POST https://{Endpoint}/rdb/v1.0/resetPassword

5.4.2 请求参数

表5-6 Body 中的请求参数

5.4.3 返回数据

5.4.4 示例

1. 请求示例
POST https://{Endpoint}/rdb/v1.0/resetPassword
{
      "InstanceId": "mysql-d8b640278c19",
    "Engine": "MySQL",
    "AccountName": "test_account",
      "AccountPassword": "U3LN2pJtW6ZU5tZbnll8NA4Q3P7bnPnDpw=="
}
2. 正常返回示例
HTTP/1.1 200 OK
Content-Type:application/json
{
     "RequestId": "3C5CFDEE-F774-4DED-89A2-1D76EC63C575"
}

意见反馈

文档内容是否对您有帮助？

如您有其他疑问，您也可以通过在线客服来与我们联系探讨在线客服