撤销用户对象权限 | OceanBase 文档中心

撤销用户对象权限

更新时间：2023-08-10 11:45:58

功能说明

撤销用户对象权限。

调用说明

接口约束

调用者需要通过 OCP 应用服务鉴权。

调用者需要具备指定租户的修改权限。

请求路径

POST /api/v2/ob/clusters/{id}/tenants/{tenantId}/users/{username}/revokeObjectPrivilege

请求参数

path 参数

参数	类型	必选	示例值	描述
id	Integer	是	1	集群 ID
tenantId	Integer	是	5	租户 ID
username	String	是	root	用户名

body 参数

参数	类型	必选	示例值	描述
objectPrivileges	Array	是	--	要撤销的对象权限列表。
├─ dbObject	Object	是	--	数据库对象，详情参见 dbObject 参数说明。
├─├─ objectType	String	是	TABLE	数据库对象类型，取值范围： * TABLE 表 * VIEW 视图 * STORED_PROCEDURE 存储过程
├─├─ objectName	String	是	table1	数据库对象名，即表名、视图名或存储过程名
├─├─ schemaName	String	是	USER1	schema名，一般与用户名相同
├─ privileges	StringArray	是	[SELECT, UPDATE]	对象的权限列表

dbObject 参数说明

参数	类型	示例值	描述
objectType	String	TABLE	数据库对象类型，取值范围： * TABLE 表 * VIEW 视图 * STORED_PROCEDURE 存储过程
objectName	String	table1	数据库对象名，即表名、视图。
schemaName	String	USER1	schema 名，一般与用户名相同。

返回结果

参数	类型	说明
successful	Boolean	请求是否成功。
timestamp	Datetime	服务端完成请求的时间戳。
duration	Integer	服务端处理请求的时间（毫秒）。
status	Integer	符合 HTTP Status 规范的编码。
traceId	String	请求的 Trace Id，用于排查问题。
server	String	响应请求的应用服务的地址。

示例

请求示例

在集群 1、租户 1000001 下撤销用户 USER1 对表 U1.T1 的 SELECT、UPDATE 权限。

POST /api/v2/ob/clusters/1/tenants/2000001/users/USER1/revokeObjectPrivilege?id=1&tenantId=2000001&username=USER1

{
  "objectPrivileges": [
    {
      "object": {
        "objectType": "TABLE",
        "objectName": "T1",
        "schemaName": "U1",
      },
      "privileges": [
        "SELECT",
        "UPDATE"
      ]
    }
  ]
}

返回示例

{
  "duration": 201,
  "server": "a83ad33525",
  "status": 200,
  "successful": true,
  "timestamp": "2021-09-07T15:30:41.205+08:00",
  "traceId": "f4783564b21746db"
}