跳到主要内容

创建权限申请

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

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

请求方法:POST

请求参数​

参数类型是否必填说明
typeString是权限类型:datasource、database、sensitiveColumn、tableView、table 或 view。
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否数据源名称。

tables 和 views 对象​

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

sensitiveColumns 对象​

参数类型是否必填说明
databaseString是数据库名。
schemaString否Schema 名。
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>"}