账号管理接口说明
所有文档

          云数据库 GaiaDB-X

          账号管理接口说明

          创建账号

          接口描述

          本接口用于在云数据库 GaiaDB-X 实例下创建一个数据库账号

          请求结构

          POST /v{version}/instance/{instanceId}/account?clientToken={clientToken} HTTP/1.1
          HOST: drds.bj.baidubce.com
          Authorization: authorization string
          {
              "accountName": accountName,
              "password": password,
              "databasePrivileges": databasePrivileges,
              "remark": remark
          }

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URI参数 API版本号
          instanceId String URI参数 实例ID
          clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串
          accountName String RequestBody参数 账号名称,由小写字母、数字、下划线组成、字母开头,字母或数字结尾,最长16个字符
          password String RequestBody参数 账号密码,由字母、数字和特殊字符(!@#$%^_)中的至少两种组成,长度8-32位。密码需要加密传输,禁止明文传输,详情请参考密码加密传输规范定义
          remark String RequestBody参数 账号备注说明
          databasePrivileges List<DatabasePrivilege> RequestBody参数 授权数据库列表信息

          DatabasePrivilege

          参数名称 类型 描述
          dbName String 数据库名称
          authType String 授权类型,ReadOnly、ReadWrite,帐号权限

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          无特殊响应参数

          请求示例

          POST https://drds.bj.baidubce.com/v1/instance/drds265l1gltivi/account?clientToken=159c9a5d-252a-47ea-bee8-70176e5c4d06
          Host: drds.bj.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          {
              "accountName": "user2",
              "password": "6af2af9b31fe977d624237938c46d670",
              "databasePrivileges": [{
                  "dbName": "dbtest",
                  "authType": "ReadWrite"
              }],
              "remark": "user1"
          }

          响应示例

          HTTP/1.1 200 OK
          x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
          Content-Type: application/json

          删除账号

          接口描述

          本接口用于在云数据库 GaiaDB-X 实例下删除一个数据库账号

          请求结构

          DELETE /v{version}/instance/{instanceId}/account/{accountName} HTTP/1.1
          HOST: drds.bj.baidubce.com
          Authorization: authorization string

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URI参数 API版本号
          instanceId String URI参数 实例ID
          accountName String URI参数 帐号名称

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数 无特殊响应参数

          请求示例

          DELETE https://drds.bj.baidubce.com/v1/instance/drds265l1gltivi/account/user1
          Host: drds.bj.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

          响应示例

          HTTP/1.1 200 OK
          x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
          Content-Type: application/json

          查询账号列表

          接口描述

          本接口用于查询云数据库 GaiaDB-X 实例下的数据库账号列表

          请求结构

          GET /v{version}/instance/{instanceId}/account HTTP/1.1
          HOST: drds.bj.baidubce.com
          Authorization: authorization string

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URI参数 API版本号
          instanceId String URI参数 实例ID

          响应头域

          除公共头域外,无其它特殊头域。

          响应参数

          参数名称 类型 描述
          accounts List<Account> 账号列表

          Account

          参数名称 类型 描述
          accountName String 账号名称
          remark String 备注说明
          status String 账号状态
          databasePrivileges List<DatabasePrivilege> 授权数据库列表信息

          请求示例

          GET https://drds.bj.baidubce.com/v1/instance/drds265l1gltivi/account
          Host: drds.bj.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

          响应示例

          HTTP/1.1 200 OK
          x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
          Content-Type: application/json
          {
              "account": [
                  {
                      "accountName": "user1",
                      "status": "Available",
                      "remark": "user1",
                      "databasePrivileges": [
                          {
                              "dbName": "dbtest",
                              "authType": "ReadOnly"
                          }
                      ]
                  },
                  {
                      "accountName": "user2",
                      "status": "Available",
                      "remark": "??user1",
                      "databasePrivileges": [
                          {
                              "dbName": "dbtest",
                              "authType": "ReadWrite"
                          }
                      ]
                  }
              ]
          }

          查询账号详情

          接口描述

          本接口用于查询云数据库 GaiaDB-X 实例下的一个数据库账号详情

          请求结构

          GET /v{version}/instance/{instanceId}/account/{accountName} HTTP/1.1
          HOST: drds.bj.baidubce.com
          Authorization: authorization string

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URI参数 API版本号
          instanceId String URI参数 实例ID
          accountName String URI参数 账号名称

          响应头域

          参数名称 类型 描述
          ETag String 当前版本号,在修改的时候需要把当前ETag通过header的方式传递回去

          响应参数

          参数名称 类型 描述
          accountName String 账号名称
          remark String 备注说明
          status String 账号状态
          databasePrivileges List<DatabasePrivilege> 授权数据库列表信息

          请求示例

          GET https://drds.bj.baidubce.com/v1/instance/drds265l1gltivi/account/user1
          Host: drds.bj.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

          响应示例

          HTTP/1.1 200 OK
          x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
          ETag: v10
          Content-Type: application/json
          {
           
              "accountName": "user1",
              "status": "Available",
              "remark": "user1",
              "databasePrivileges": [
                  {
                      "dbName": "dbtest",
                      "authType": "ReadOnly"
                  }
              ]
          }

          修改账号密码

          接口描述

          本接口用于修改云数据库 GaiaDB-X 实例下一个数据库账号的密码

          请求结构

          PUT /v{version}/instance/{instanceId}/account/{accountName}?modifyPassword HTTP/1.1
          HOST: drds.bj.baidubce.com
          Authorization: authorization string
          {
              "password": password
          }

          请求头域

          除公共头域外,无其它特殊头域。

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URI参数 API版本号
          instanceId String URI参数 实例ID
          accountName String URI参数 账号名称
          password String RequestBody参数 账号密码,由字母、数字和特殊字符(!@#$%^_)中的至少两种组成,长度8-32位。密码需要加密传输,禁止明文传输,详情请参考密码加密传输规范定义

          响应头域

          参数名称 类型 描述
          ETag String 当前版本号,在修改的时候需要把当前ETag通过header的方式传递回去

          响应参数

          参数名称 类型 描述
          accountName String 账号名称
          remark String 备注说明
          status String 账号状态
          databasePrivileges List<DatabasePrivilege> 授权数据库列表信息

          请求示例

          PUT https://drds.bj.baidubce.com/v1/instance/drds265l1gltivi/account/user1?modifyPassword
          Host: drds.bj.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          {
              "password": "6af2af9b31fe977d624237938c46d670"
          }

          响应示例

          HTTP/1.1 200 OK
          x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
          Content-Type: application/json

          修改账号权限

          接口描述

          本接口用于修改云数据库 GaiaDB-X 实例下一个数据库账号的权限

          请求结构

          PUT /v{version}/instance/{instanceId}/account/{accountName}?modifyPrivilege HTTP/1.1
          HOST: drds.bj.baidubce.com
          x-bce-if-match:{ETag}
          Authorization: authorization string
          {
              "databasePrivileges": databasePrivileges
          }

          请求头域

          参数名称 类型 描述
          x-bce-if-match String 通过账号详情接口获取到的ETag值

          请求参数

          参数名称 类型 是否必需 参数位置 描述
          version String URI参数 API版本号
          instanceId String URI参数 实例ID
          accountName String URI参数 账号名称
          databasePrivileges List<DatabasePrivilege> RequestBody参数 更新帐号数据权限列表

          响应头域

          除公共头域,无其它特殊头域。

          响应参数 无特殊响应参数。

          请求示例

          PUT https://drds.bj.baidubce.com/v1/instance/drds265l1gltivi/account/user1?updatePrivilege
          Host: drds.bj.baidubce.com
          Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
          {
              "databasePrivileges": [
                  {
                      "dbName": "dbtest",
                      "authType": "ReadOnly"
                  }
              ]
          }

          响应示例

          HTTP/1.1 200 OK
          x-bce-request-id: 7869616F-7A68-6977-656E-406261696475
          Content-Type: application/json
          上一篇
          数据表管理接口说明
          下一篇
          白名单管理接口说明