全部產品
Search
文件中心

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

更新時間:Jun 09, 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"
        }
      ]
    }
  }
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情