GetProcessInstance - DataWorks - Centro de documentación de Alibaba Cloud

Obtiene los detalles de una instancia de proceso de aprobación especificada, incluidos sus nodos de aprobación y la lista de tareas.

Descripción de la operación

Solicitud

Esta API se utiliza para monitorear y gestionar el estado de un proceso de aprobación. Al proporcionar el ID de la instancia del proceso de aprobación, puede consultar información relacionada, como la definición del proceso de aprobación, los nodos de aprobación actuales y las tareas en cada nodo.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dataworks:GetProcessInstance

get

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ProcessInstanceId	string	Sí	El ID de la instancia del proceso.	332066440109224007

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los datos devueltos.
RequestId	string	El ID de la solicitud. Utilice este ID para localizar registros y solucionar problemas.	0bc5df3a17****903790e8e8a
ProcessInstance	object	Detalles de la instancia del proceso de aprobación.
Id	string	El ID de la instancia del proceso.	332066440109224007
Title	string	El nombre de la instancia del proceso.	MaxCompute表权限申请
Status	string	El estado de la instancia del proceso. Valores válidos: `Completed`: La solicitud está aprobada. `Running`: La solicitud se encuentra en el proceso de aprobación. `Aborted`: La solicitud ha sido retirada. Valores válidos: running : running. aborted : aborted. completed : completed.	completed
Applicator	string	El ID de usuario del solicitante.	1107558004253538
ApplicatorName	string	El nombre de usuario de la cuenta de Alibaba Cloud del solicitante.	test_account
StartTime	any	La hora en que comenzó el proceso de aprobación.	2026-05-25 10:20:18 CST
Reason	string	El motivo de la solicitud.	业务需要
AuthErrorMessage	string	El mensaje de error de autorización. Nota: Este parámetro se devuelve solo si la autorización falla.	S-400007:ODPS acl auth failed. odps table acl auth failed
ApprovalTasks	array<object>	Las tareas de aprobación.
	array<object>	Una tarea de aprobación.
Id	string	El ID de la tarea de aprobación.	task_001
Status	string	El estado de la tarea. Valores válidos: `Completed`: La tarea está completada. `Pending`: La tarea está pendiente. `Aborted`: La tarea ha sido cancelada. Valores válidos: Completed : Completed. Pending : Pending. Aborted : Aborted.	Aborted
ApprovalComment	string	El comentario de aprobación.	同意
Assignee	string	El ID de usuario del aprobador real.	207947399706614297
AssigneeName	string	El nombre del aprobador real.	李四
ApprovalDecision	string	La decisión de aprobación. Valores válidos: `Agree` `Deny` Valores válidos: deny : deny. agree : agree.	Deny
CreateTime	integer	La hora en que se creó la tarea.	1715587200000
CompleteTime	integer	La hora en que se completó la tarea.	1715590800000
ApprovalNode	object	El nodo de aprobación de la política de aprobación correspondiente.
Id	string	El ID del nodo.	7a809b6a-2a62-4c6c-9c23-c2a145e3877d
Name	string	El nombre del nodo.	default-name
AccountType	string	El tipo de aprobador para el nodo. Valores válidos: `DataWorksProjectRole`: Un rol de espacio de trabajo `DataWorksProjectMember`: Un miembro del espacio de trabajo `TableAdministrator`: Un administrador de tablas `TableOrProjectAdministrator`: Un administrador de tablas o de espacio de trabajo `AliyunResourceOwner`: Una cuenta de Alibaba Cloud `MaxComputeRole`: Un rol de MaxCompute `DLFAdmin`: Un administrador de DlfLegacy `DLFNextAdmin`: Un administrador de DLFNext `TenantRole`: Un rol de inquilino `EmrAdministrator`: Un administrador de Emr `LindormAdministrator`: Un administrador de Lindorm `AliyunRamUser`: Un usuario de RAM Valores válidos: AliyunResourceOwner : Cuenta de Alibaba Cloud. MaxComputeRole : Rol de MaxCompute. DLFNextAdmin : Administrador de DLFNext. TenantRole : Rol de inquilino. DataWorksProjectRole : Rol de espacio de trabajo. AliyunRamUser : Usuario de RAM. TableOrProjectAdministrator : Administrador de tablas o de espacio de trabajo. EmrAdministrator : Administrador de Emr. TableAdministrator : Administrador de tablas. DLFAdmin : Administrador de DlfLegacy. DataWorksProjectMember : Miembro del espacio de trabajo. LindormAdministrator : Administrador de Lindorm.	DataWorksProjectRole
Assignees	array	Los aprobadores especificados. El contenido de este parámetro depende del valor de `AccountType`: Si `AccountType` es `DataWorksProjectMember`, este parámetro contiene los ID de usuario de los miembros del espacio de trabajo. Si `AccountType` es `DataWorksProjectRole`, este parámetro contiene los códigos de los roles del espacio de trabajo. Si `AccountType` es `MaxComputeRole`, este parámetro contiene los roles de MaxCompute. Si `AccountType` es `TenantRole`, este parámetro contiene los códigos de los roles de inquilino. Si `AccountType` es `AliyunRamUser`, este parámetro contiene los ID de usuario de los usuarios de RAM.
	string	Un aprobador.	role_project_admin
TaskCandidates	array<object>	Los aprobadores candidatos para la tarea.
	object	Un aprobador candidato.
MemberUserId	string	El ID de usuario del aprobador.	207947397776614297
MemberName	string	El nombre del aprobador.	李四
ApprovalProcessDefinition	object	La política de aprobación aplicada a esta instancia de proceso.
Id	string	El ID de la política de aprobación.	323861511451222099
Name	string	El nombre de la política de aprobación.	SYSTEM_GENERATE_DEFAULT
Description	string	La descripción de la política de aprobación.	流程定义描述
Type	string	El tipo de la política de aprobación. Valores válidos: `MaxCompute` `DataService` `DlfV1` (No se admite la creación personalizada) `Extension` `Hologres` `Emr` (No se admite la creación personalizada) `DataAssetGovernance` (No se admite la creación personalizada) `Lindorm` (No se admite la creación personalizada) `StarRocks` (No se admite la creación personalizada) `DlfNext` (No se admite la creación personalizada) `DataWorks` (No se admite la creación personalizada)	MaxCompute
SubType	string	El subtipo de la política de aprobación. Valores válidos: `Table` `Column` `Database` `Schema` `Default`	Table
Enabled	boolean	Indica si la política está habilitada.	true
RuleConditions	array<object>	Las reglas que determinan cuándo entra en vigor la política de aprobación.
	object	Una regla que determina cuándo entra en vigor la política de aprobación.
Type	string	El tipo de condición de la regla. Valores válidos: `odpsProject`: Se aplica a un proyecto específico de MaxCompute. `hologresInstanceId`: Se aplica a una instancia específica de Hologres. `sensibleLevel`: Se aplica a un nivel de seguridad específico. `tableGuid`: Se aplica a una tabla específica. `projectId`: Se aplica a un espacio de trabajo específico. Valores válidos: tableGuid : tableGuid. hologresInstanceId : hologresInstanceId. sensibleLevel : sensibleLevel. odpsProject : odpsProject. projectId : projectId.	odpsProject
Expression	string	La expresión de la condición de la regla. Formato: `((#type=='typeValue'))`.	((#odpsProject=='PX_BEIJING_TEST'))
Scope	string	El alcance de la regla. Valores válidos: `Deployment`: Determina si la política se aplica cuando se envía una solicitud. `Running`: Determina si se debe omitir la aprobación mientras se ejecuta la instancia del proceso. Este valor solo se admite para políticas de aprobación de MaxCompute. Valores válidos: Running : Omitir aprobación mientras se ejecuta la instancia del proceso. Deployment : Entra en vigor cuando se activa una solicitud.	Deployment
NotificationServices	array<object>	Los servicios de notificación.
	object	Un servicio de notificación.
Channel	string	El canal de notificación. Valores válidos: `Mail` `Sms` `DingRobot` `Weixin` Valores válidos: Mail : Correo electrónico. Weixin : A webhook. Sms : SMS. DingRobot : Chatbot de DingTalk.	Mail
Extension	string	Información adicional en formato JSON. Por ejemplo, `{"atAll":"true"}` indica si se debe mencionar a todos los miembros (@all).	{"atAll":"true"}
Receiver	string	Si `Channel` se establece en `DingRobot` o `Weixin`, el valor de este parámetro debe ser la URL del webhook.	https://dingtalk
ApprovalNodes	array<object>	Los nodos de aprobación.
	object	Un nodo de aprobación.
Id	string	El ID del nodo.	7a809b6a-2a62-4c6c-9c23-c2a145e3877d
Name	string	El nombre del nodo.	default-name
AccountType	string	El tipo de aprobador para el nodo. Valores válidos: `DataWorksProjectRole`: Un rol de espacio de trabajo `DataWorksProjectMember`: Un miembro del espacio de trabajo `TableAdministrator`: Un administrador de tablas `TableOrProjectAdministrator`: Un administrador de tablas o de espacio de trabajo `AliyunResourceOwner`: Una cuenta de Alibaba Cloud `MaxComputeRole`: Un rol de MaxCompute `DLFAdmin`: Un administrador de DlfLegacy `DLFNextAdmin`: Un administrador de DLFNext `TenantRole`: Un rol de inquilino `EmrAdministrator`: Un administrador de Emr `LindormAdministrator`: Un administrador de Lindorm `AliyunRamUser`: Un usuario de RAM	DataWorksProjectRole
Assignees	array	Los aprobadores especificados. El contenido de este parámetro depende del valor de `AccountType`: Si `AccountType` es `DataWorksProjectMember`, este parámetro contiene los ID de usuario de los miembros del espacio de trabajo. Si `AccountType` es `DataWorksProjectRole`, este parámetro contiene los códigos de los roles del espacio de trabajo. Si `AccountType` es `MaxComputeRole`, este parámetro contiene los roles de MaxCompute. Si `AccountType` es `TenantRole`, este parámetro contiene los códigos de los roles de inquilino. Si `AccountType` es `AliyunRamUser`, este parámetro contiene los ID de usuario de los usuarios de RAM.
	string	Un aprobador.	role_project_admin
ExtensionProperties	string	La descripción extendida del nodo de aprobación.	none

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.