GetProcessInstance - DataWorks - Alibaba Cloud ドキュメントセンター

指定された承認プロセスインスタンスの詳細を取得します。承認ノードおよびタスクリストを含みます。

操作説明

Request

This API is used to monitor and manage the status of an approval process. By providing the approval process instance ID, you can query for related information, such as the approval process definition, current approval nodes, and the tasks on each node.

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ProcessInstanceId	string	必須	プロセスインスタンスの ID。	332066440109224007

レスポンスフィールド

フィールド	型	説明	例
	object	The returned data.
RequestId	string	The request ID. Use this ID to locate logs and troubleshoot issues.	0bc5df3a17****903790e8e8a
ProcessInstance	object	Details of the approval process instance.
Id	string	The process instance ID.	332066440109224007
Title	string	The name of the process instance.	MaxCompute表权限申请
Status	string	The status of the process instance. Valid values: `Completed`: The request is approved. `Running`: The request is in the approval process. `Aborted`: The request is withdrawn. 列挙値: running : running aborted : aborted completed : completed	completed
Applicator	string	The user ID of the applicant.	1107558004253538
ApplicatorName	string	The username of the applicant's Alibaba Cloud account.	test_account
StartTime	any	The time when the approval process started.	2026-05-25 10:20:18 CST
Reason	string	The reason for the request.	业务需要
AuthErrorMessage	string	The authorization failure message. Note: This parameter is returned only if the authorization fails.	S-400007:ODPS acl auth failed. odps table acl auth failed
ApprovalTasks	array<object>	The approval tasks.
	array<object>	An approval task.
Id	string		task_001
Status	string	列挙値: Completed : Completed Pending : Pending Aborted : Aborted	Aborted
ApprovalComment	string		同意
Assignee	string		207947399706614297
AssigneeName	string		李四
ApprovalDecision	string	列挙値: deny : deny agree : agree	deny
CreateTime	integer		1715587200000
CompleteTime	integer		1715590800000
ApprovalNode	object
Id	string		7a809b6a-2a62-4c6c-9c23-c2a145e3877d
Name	string		default-name
AccountType	string	列挙値: AliyunResourceOwner : 阿里云账号 MaxComputeRole : MaxCompute 角色 DLFNextAdmin : DLFNext 管理员 TenantRole : 租户角色 DataWorksProjectRole : 工作空间角色 AliyunRamUser : RAM 子账号 TableOrProjectAdministrator : 表或空间管理员 EmrAdministrator : Emr 管理员 TableAdministrator : 表负责人 DLFAdmin : DlfLegacy 管理员 DataWorksProjectMember : 工作空间成员 LindormAdministrator : Lindorm 管理员	DataWorksProjectRole
Assignees	array
	string		role_project_admin
TaskCandidates	array<object>
	object
MemberUserId	string		207947397776614297
MemberName	string		李四
ApprovalProcessDefinition	object	The approval policy applied to this process instance.
Id	string		323861511451222099
Name	string		SYSTEM_GENERATE_DEFAULT
Description	string		流程定义描述
Type	string		MaxCompute
SubType	string		Table
Enabled	boolean		true
RuleConditions	array<object>
	object
Type	string	列挙値: tableGuid : tableGuid hologresInstanceId : hologresInstanceId sensibleLevel : sensibleLevel odpsProject : odpsProject projectId : projectId	odpsProject
Expression	string		((#odpsProject=='PX_BEIJING_TEST'))
Scope	string	列挙値: Running : 流程实例进行时免批 Deployment : 触发申请时生效	Deployment
NotificationServices	array<object>
	object
Channel	string	列挙値: Mail : 邮件 Weixin : WebHook Sms : 短信 DingRobot : 钉钉机器人	Mail
Extension	string		{"atAll":"true"}
Receiver	string		https://dingtalk
ApprovalNodes	array<object>
	object
Id	string		7a809b6a-2a62-4c6c-9c23-c2a145e3877d
Name	string		default-name
AccountType	string		DataWorksProjectRole
Assignees	array
	string		role_project_admin
ExtensionProperties	string		none

例

成功レスポンス

JSONJSON

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

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。