全部產品
Search
文件中心

DataWorks:GetProcessInstance - 查詢審批次程序執行個體

更新時間:Sep 03, 2026

擷取指定審批次程序執行個體的詳細資料,包括審批節點和工作清單。

介面說明

請求說明

通過提供審批次程序執行個體 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 :

    DingTalk機器人

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"
        }
      ]
    }
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情。