跳到主要内容

创建权限申请

为数据源、数据库、表、视图或敏感列创建权限申请。此接口不需要管理员权限,但需要 AccessKey 认证。

请求地址:/openapi/v1/permission/apply/create

请求方法:POST

请求参数

参数类型是否必填说明
typeString权限类型:datasourcedatabasesensitiveColumntableViewtableview
datasourceObject目标数据源对象,字段见下表。
databasesArray<String>数据库列表。
schemasArray<String>Schema 列表。
tablesArray<Object>表对象列表,字段见下表。
viewsArray<Object>视图对象列表,字段见下表。
sensitiveColumnsArray<Object>敏感列对象列表,字段见下表。
permissionsObject权限配置,结构见下表。
reasonString申请原因。
daysInteger有效天数。
sensitiveLevelInteger敏感级别。
endDateTimeString权限结束时间,使用 ISO 8601 格式,例如 2026-08-30T10:00:00Z
approversArray<Object>审批人对象列表,字段见下表。
refusalString拒绝原因。

datasource 对象

参数类型是否必填说明
datasource.datasourceIdString数据源 ID。
datasource.nameString数据源名称。

tablesviews 对象

参数类型是否必填说明
databaseString数据库名。
schemaStringSchema 名。
nameString表名或视图名。

sensitiveColumns 对象

参数类型是否必填说明
databaseString数据库名。
schemaStringSchema 名。
tableString表名。
columnString列名。

permissions 对象

permissions 的键是与 type 对应的权限类型,值是权限动作数组,例如 {"database": ["Readonly"]}

approvers 对象

参数类型是否必填说明
accountIdString审批人账号 ID。
accountNameString审批人账号名称。
specifyApproverBoolean是否指定审批人。
selfApprovalBoolean是否允许自审批。
statusString审批状态。

请求示例

{
"type": "database",
"datasource": {
"datasourceId": "<datasourceId>",
"name": "example-datasource"
},
"databases": ["example_db"],
"permissions": {
"database": ["Readonly"]
},
"reason": "Need read access",
"endDateTime": "2026-08-30T10:00:00Z"
}

返回参数

参数类型说明
successBoolean请求是否成功。
requestIdString请求 ID。
dataString新创建的权限申请 ID。

调用成功示例

{"success": true, "requestId": "<requestId>", "data": "<applyId>"}