GetProcessInstance - 查询审批流程实例 - 大数据开发治理平台 DataWorks

获取指定审批流程实例的详细信息，包括审批节点和任务列表。

接口说明

请求说明

通过提供审批流程实例 ID，可以查询到该审批流程实例的所有相关信息，如审批流程定义、当前状态下的审批节点以及每个节点上的审批任务详情。此 API 主要用于监控和管理审批流程的状态。

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
ProcessInstanceId	string	是	流程实例 ID	332066440109224007

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求 ID。用于定位日志，排查问题。	0bc5df3a17****903790e8e8a
ProcessInstance	object	审批流程实例详情
Id	string	流程实例 ID。	332066440109224007
Title	string	流程实例名称	MaxCompute表权限申请
Status	string	流程实例状态。取值如下： Completed，已审批。 Running，审批中。 Aborted，已撤回。枚举值： running : running aborted : aborted completed : completed	completed
Applicator	string	申请人 UserId	1107558004253538
ApplicatorName	string	申请人阿里云账号名称。	test_account
StartTime	any	发起申请时间	2026-05-25 10:20:18 CST
Reason	string	申请理由	业务需要
AuthErrorMessage	string	授权失败信息。注意：只有授权失败时才会存在。	S-400007:ODPS acl auth failed. odps table acl auth failed
ApprovalTasks	array<object>	审批任务列表
	array<object>	审批任务
Id	string	审批任务 ID	task_001
Status	string	任务状态： Completed：完成 Pending：待处理 Aborted：已中止枚举值： Completed : Completed Pending : Pending Aborted : Aborted	Aborted
ApprovalComment	string	审批意见	同意
Assignee	string	实际审批人 UserId	207947399706614297
AssigneeName	string	实际审批人名称	李四
ApprovalDecision	string	审批决策： Agree Deny 枚举值： deny : deny agree : agree	Deny
CreateTime	integer	任务创建时间	1715587200000
CompleteTime	integer	任务结束时间	1715590800000
ApprovalNode	object	审批策略中审批节点
Id	string	节点 id	7a809b6a-2a62-4c6c-9c23-c2a145e3877d
Name	string	节点名称	default-name
AccountType	string	节点审批人类型： DataWorksProjectRole 空间角色 DataWorksProjectMember 空间成员 TableAdministrator 表负责人 TableOrProjectAdministrator 表或空间管理员 AliyunResourceOwner 阿里云账号 MaxComputeRole MC 角色 DLFAdmin DlfLegacy 管理员 DLFNextAdmin DLFNext 管理员 TenantRole 租户角色 EmrAdministrator Emr 管理员 LindormAdministrator Lindorm 管理员 AliyunRamUser RAM 子账号枚举值： AliyunResourceOwner : 阿里云账号 MaxComputeRole : MaxCompute 角色 DLFNextAdmin : DLFNext 管理员 TenantRole : 租户角色 DataWorksProjectRole : 工作空间角色 AliyunRamUser : RAM 子账号 TableOrProjectAdministrator : 表或空间管理员 EmrAdministrator : Emr 管理员 TableAdministrator : 表负责人 DLFAdmin : DlfLegacy 管理员 DataWorksProjectMember : 工作空间成员 LindormAdministrator : Lindorm 管理员	DataWorksProjectRole
Assignees	array	具体指定的审批人。当 AccountType 为不同类型，对应不同语义： DataWorksProjectMember 声明空间成员 UserId DataWorksProjectRole 声明空间角色 code MaxComputeRole 声明 MC 的角色 TenantRole 声明租户角色 code AliyunRamUser 声明 RAM userId
	string	审批人	role_project_admin
TaskCandidates	array<object>	任务候选审批人列表
	object	候选审批人
MemberUserId	string	审批人 UserId	207947397776614297
MemberName	string	审批人名称	李四
ApprovalProcessDefinition	object	当前流程实例对应的审批策略
Id	string	审批策略 ID	323861511451222099
Name	string	审批策略名称	SYSTEM_GENERATE_DEFAULT
Description	string	审批策略描述	流程定义描述
Type	string	审批策略类型，枚举： MaxCompute DataService DlfV1 【不支持自定义新建】 Extension Hologres Emr 【不支持自定义新建】 DataAssetGovernance【不支持自定义新建】 Lindorm【不支持自定义新建】 StarRocks【不支持自定义新建】 DlfNext【不支持自定义新建】 DataWorks【不支持自定义新建】	MaxCompute
SubType	string	审批策略子类型： Table Column Database Schema Default	Table
Enabled	boolean	是否启用	true
RuleConditions	array<object>	审批策略生效规则列表
	object	审批策略生效规则
Type	string	审批策略生效类型： odpsProject：指定 MaxCompute 项目下生效 hologresInstanceId：执行 Hologres 实例下生效 sensibleLevel：指定安全等级下生效 tableGuid：指定的 table 下生效 projectId：指定的工作空间 ID 下生效枚举值： tableGuid : tableGuid hologresInstanceId : hologresInstanceId sensibleLevel : sensibleLevel odpsProject : odpsProject projectId : projectId	odpsProject
Expression	string	策略生效条件表达式。((#type=='typeValue'))。	((#odpsProject=='PX_BEIJING_TEST'))
Scope	string	规则生效阶段： Deployment ：用于判定"提交申请时是否匹配该审批策略 Running ：用于审批流程执行判定是否免审批【仅支持 MaxCompute 类型】枚举值： Running : 流程实例进行时免批 Deployment : 触发申请时生效	Deployment
NotificationServices	array<object>	通知服务列表
	object	通知服务
Channel	string	通知渠道： Mail Sms DingRobot Weixin 枚举值： Mail : 邮件 Weixin : WebHook Sms : 短信 DingRobot : 钉钉机器人	Mail
Extension	string	扩展信息，JSON 格式，如 {"atAll":"true"}声明是否@所有人	{"atAll":"true"}
Receiver	string	Channel 为 DingRobot/Weixin 时，需要指定 WebhookUrl 作为接收人	https://dingtalk
ApprovalNodes	array<object>	审批节点列表
	object	审批节点
Id	string	节点 id	7a809b6a-2a62-4c6c-9c23-c2a145e3877d
Name	string	节点名称	default-name
AccountType	string	节点审批人类型： DataWorksProjectRole 空间角色 DataWorksProjectMember 空间成员 TableAdministrator 表负责人 TableOrProjectAdministrator 表或空间管理员 AliyunResourceOwner 阿里云账号 MaxComputeRole MC 角色 DLFAdmin DlfLegacy 管理员 DLFNextAdmin DLFNext 管理员 TenantRole 租户角色 EmrAdministrator Emr 管理员 LindormAdministrator Lindorm 管理员 AliyunRamUser RAM 子账号	DataWorksProjectRole
Assignees	array	具体指定的审批人。当 AccountType 为不同类型，对应不同语义： DataWorksProjectMember 声明空间成员 UserId DataWorksProjectRole 声明空间角色 code MaxComputeRole 声明 MC 的角色 TenantRole 声明租户角色 code AliyunRamUser 声明 RAM userId
	string	审批人	role_project_admin
ExtensionProperties	string	审批节点扩展说明	none

示例

正常返回示例

JSON格式

{
  "RequestId": "0bc5df3a17****903790e8e8a",
  "ProcessInstance": {
    "Id": "332066440109224007",
    "Title": "MaxCompute表权限申请",
    "Status": "completed",
    "Applicator": "1107558004253538",
    "ApplicatorName": "test_account",
    "StartTime": "2026-05-25 10:20:18 CST",
    "Reason": "业务需要",
    "AuthErrorMessage": "S-400007:ODPS acl auth failed. odps table acl auth failed",
    "ApprovalTasks": [
      {
        "Id": "task_001",
        "Status": "Aborted",
        "ApprovalComment": "同意",
        "Assignee": "207947399706614297",
        "AssigneeName": "李四",
        "ApprovalDecision": "Deny",
        "CreateTime": 1715587200000,
        "CompleteTime": 1715590800000,
        "ApprovalNode": {
          "Id": "7a809b6a-2a62-4c6c-9c23-c2a145e3877d",
          "Name": "default-name",
          "AccountType": "DataWorksProjectRole",
          "Assignees": [
            "role_project_admin"
          ]
        },
        "TaskCandidates": [
          {
            "MemberUserId": "207947397776614297",
            "MemberName": "李四"
          }
        ]
      }
    ],
    "ApprovalProcessDefinition": {
      "Id": "323861511451222099",
      "Name": "SYSTEM_GENERATE_DEFAULT",
      "Description": "流程定义描述",
      "Type": "MaxCompute",
      "SubType": "Table",
      "Enabled": true,
      "RuleConditions": [
        {
          "Type": "odpsProject",
          "Expression": "((#odpsProject=='PX_BEIJING_TEST'))",
          "Scope": "Deployment"
        }
      ],
      "NotificationServices": [
        {
          "Channel": "Mail",
          "Extension": "{\"atAll\":\"true\"}",
          "Receiver": "https://dingtalk"
        }
      ],
      "ApprovalNodes": [
        {
          "Id": "7a809b6a-2a62-4c6c-9c23-c2a145e3877d",
          "Name": "default-name",
          "AccountType": "DataWorksProjectRole",
          "Assignees": [
            "role_project_admin"
          ],
          "ExtensionProperties": "none"
        }
      ]
    }
  }
}

错误码

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

变更历史

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