ListPendingApprovals - 查询待审批的权限申请单 - 大数据开发治理平台 DataWorks

获取当前用户作为审批人、待处理的权限申请单列表。

接口说明

请求说明

本接口用于查询当前登录用户作为审批人的所有待处理权限申请单。支持通过多种条件进行筛选，包括资源类型、时间范围、审批状态等，以便更精确地定位到特定的申请单。

ResourceType：指定资源类型（如表），可以是多个值。
Resource：提供具体的资源检索条件，比如所属项目、数据库或表名。
StartTime 和 EndTime：定义了申请发起的时间范围。
Statuses：允许按审批状态过滤结果，例如只查看待审批的状态。
Grantee：根据授权对象的信息来过滤申请单。
AccessTypes：基于请求的具体权限类型（如读取、更新）来筛选。
PageSize 和 NextToken：用于分页控制，每次请求返回的数据量以及获取下一页数据所需的游标。

注意事项：

如果不提供任何筛选条件，则默认返回所有符合条件的记录。
NextToken 参数在首次调用时可为空或省略；后续页面请求需使用上一次响应中提供的 NextToken 值。
PageSize 的默认值为 10，最大值为 200。如果设置的值超过最大限制，则按最大值处理。
当没有更多数据可返回时，HasMore 字段将被设置为 false，并且 NextToken 将为空或不存在。

响应说明

成功调用该 API 后，响应体中包含分页结果及每条申请单的详细信息，如申请时间、资源描述、授权对象、请求权限等。此外，还提供了审批流程的状态和其他相关元数据。

Data：分页结果集，包括每页大小 (PageSize)、游标 (NextToken) 和是否还有更多数据 (HasMore) 等信息。
ApplicationQueryResponse：每个申请单的具体内容，包括申请理由、发起时间、状态以及详细的申请内容列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
DefSchema	string	是	根据资源类型筛选。注意：系统支持申请的资源类型受 ResourceSchema .name 约束。附： ResourceSchema 国际站说明文档	MaxCompute
ResourceType	array	是	根据最小权限资源类型筛选。注意：最小权限资源类型受 ResourceSchema . resources[*].isValidLeaf 为 true 约束。附： ResourceSchema 国际站说明文档	["table", "column"]
	string	否	资源类型	table
Resource	object	否	根据资源做精确/泛化筛选，资源的描述受 ResourceSchema 约束。附： ResourceSchema 国际站说明文档
DefSchema	string	否	资源类型。注意：系统支持申请的资源类型受 ResourceSchema .name 约束。附： ResourceSchema 国际站说明文档	MaxCompute
DefVersion	string	否	资源解析版本受 ResourceSchema .version 约束。 ResourceSchema 国际站说明文档	v1.0.0
MetaData	object	否	资源元数据。注意：元数据受 ResourceSchema .resources 约束，有效的资源声明需要包含 level 0 到 validLeaf 层的全路径元数据声明。附： ResourceSchema 国际站说明文档
	any	否	资源元数据	{ "workspace": "449056", "project": "sync_destination" }
StartTime	integer	否	申请时间开始（毫秒时间戳）	1771948800000
EndTime	integer	否	申请时间结束（毫秒时间戳）	1779724799999
Grantee	object	否	根据授权主体筛选。注意：系统支持的授权主体类型受 ResourceSchema .authPrincipal 约束。附： ResourceSchema 国际站说明文档
PrincipalType	string	否	授权主体类型	RamRole
PrincipalId	string	否	授权主体 ID	ROLE_3133343434
AccessTypes	array	否	根据申请的权限筛选。注意：不同层级资源支持权限的申请类型不同，统一受 ResourceSchema .isValidLeaf 和 accessTypeRestrictions 和 authMethodAccessTypes 约束。附： ResourceSchema 国际站说明文档
	string	否	权限	select
NextToken	string	否	游标	eyJpZCI6MTIzfQ==
PageSize	integer	否	每页大小（默认 10，最大 200）	20

返回参数

名称	类型	描述	示例值
	object	API 请求响应错误码，调用出错时非空
RequestId	string	API 请求 ID，uuid 生成	0bc5df3a17****903790e8e8a
Data	object	分页结果
PageSize	integer	每页大小（默认 10，最大 200）	10
NextToken	string	游标	eyJpZCI6MTIzfQ==
HasMore	boolean	是否有更多数据	false
Data	array<object>	分页结果中的数据列表
	array<object>	审批流程与申请内容
ProcessInstanceId	string	流程实例 ID	176906667488145
DefSchema	string	资源类型	MaxCompute
Reason	string	申请理由	业务需要
ApplicationTime	integer	申请发起时间	申请时间
Status	string	审批状态筛选。枚举： WaitApproval 待审批 Confirmed 待授权 RejectApproval 审批拒绝 AuthorizeSucceed 授权成功 AuthorizeFailed 授权失败 Deleted 已删除 Canceled 已撤回	Deleted
Contents	array<object>	申请内容
	array<object>	申请内容
Id	string	申请内容唯一标识	210001918826
ProcessInstanceId	string	流程实例 ID	176906667488145
TenantId	string	租户 ID	69973837489
ResourceName	string	最小权限资源类型	table
DefSchema	string	资源类型	MaxCompute
AuthMethod	string	授权方式	default
Resource	object	资源声明
DefSchema	string	资源解析依赖的 ResourceSchema.name	MaxCompute
DefVersion	string	资源解析依赖的 ResourceSchema.version	v1.0.0
MetaData	object	资源元数据，数据内容受 ResourceSchema 约束
	any	资源内容	{ "schema": "default", "threeTierModel": false, "project": "sync_dtestn", "workspace": "4477656", "table": "order", "tenant": "524257424864736" }
Grantee	object	授权主体描述
PrincipalType	string	主体类型，枚举： RamRole RamUser DataworksTenantMember DataworksTenantRole DataworksProjectMember DataworksProjectRole DlfRole	RamUser
PrincipalId	string	主体 ID。注意：当 principalType 为不同类型时，对应不同语义： RamUser：Dataworks UserId RamRole："ROLE_"开头的 Dataworks UserId DataworksTenantMember：Dataworks UserId DataworksTenantRole：Dataworks tenant roleCode DataworksProjectRole：Dataworks workspace roleCode DataworksProjectMember：Dataworks UserId DlfRole：DlfNext role name	213463068144525171
AccessTypes	array	发起申请的资源操作权限
	string	权限	select
FinalAccessTypes	array	最终审批通过的资源操作权限
	string	select	select
ExpirationTime	integer	权限截止日期，毫秒时间戳	1782354014507
Status	string	审批状态筛选。枚举： WaitApproval 待审批 Confirmed 待授权 RejectApproval 审批拒绝 AuthorizeSucceed 授权成功 AuthorizeFailed 授权失败 Deleted 已删除 Canceled 已撤回	Deleted
CreateTime	integer	创建时间	2025-09-11 10:13:21
UpdateTime	integer	更新时间	2022-07-06 19:13:05

示例

正常返回示例

JSON格式

{
  "RequestId": "0bc5df3a17****903790e8e8a",
  "Data": {
    "PageSize": 10,
    "NextToken": "eyJpZCI6MTIzfQ==",
    "HasMore": false,
    "Data": [
      {
        "ProcessInstanceId": "176906667488145",
        "DefSchema": "MaxCompute",
        "Reason": "业务需要",
        "ApplicationTime": 0,
        "Status": "Deleted",
        "Contents": [
          {
            "Id": "210001918826",
            "ProcessInstanceId": "176906667488145",
            "TenantId": "69973837489",
            "ResourceName": "table",
            "DefSchema": "MaxCompute",
            "AuthMethod": "default",
            "Resource": {
              "DefSchema": "MaxCompute",
              "DefVersion": "v1.0.0",
              "MetaData": {
                "key": "{\n                \"schema\": \"default\",\n                \"threeTierModel\": false,\n                \"project\": \"sync_dtestn\",\n                \"workspace\": \"4477656\",\n                \"table\": \"order\",\n                \"tenant\": \"524257424864736\"\n              }"
              }
            },
            "Grantee": {
              "PrincipalType": "RamUser",
              "PrincipalId": "213463068144525171"
            },
            "AccessTypes": [
              "select"
            ],
            "FinalAccessTypes": [
              "select"
            ],
            "ExpirationTime": 1782354014507,
            "Status": "Deleted",
            "CreateTime": 0,
            "UpdateTime": 0
          }
        ]
      }
    ]
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。