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

Actualiza una definición de proceso de aprobación existente.

Descripción de la operación

Solicitud

Utilice esta API para modificar una definición de proceso de aprobación existente, incluidos el nombre, la descripción, las condiciones de regla, el servicio de notificación y los nodos de aprobación.
El parámetro obligatorio Id identifica la definición de proceso de aprobación que se va a actualizar.
Para sobrescribir la configuración existente, establezca el parámetro Overwrite en true.
El parámetro opcional ClientToken garantiza la idempotencia de la solicitud.

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:UpdateProcessDefinition

update

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Id	string	Sí	El ID de la definición de proceso.	177554881536128
Name	string	No	El nombre de la definición de proceso.	MaxCompute table approval
Description	string	No	La descripción de la definición de proceso.	MaxCompute table approval policy for the lwt_ide_simple project
RuleConditions	array<object>	No	Una lista de condiciones de regla. Este parámetro no se aplica a las políticas del sistema.
	object	No	Una condición de regla.
Type	string	No	El tipo de condición. Valores válidos: `odpsProject` `hologresInstanceId` `sensibleLevel` `tableGuid` `projectId`	odpsProject
Scope	string	No	La fase en la que la regla surte efecto. Valores válidos: Deployment: Determina si la política de aprobación se aplica cuando se envía una solicitud. Running: Determina si se debe omitir la aprobación durante el proceso de aprobación. Esta fase solo es compatible con MaxCompute.	Deployment
Expression	string	No	La expresión condicional. Formato: ((#type=='typeValue')). Por ejemplo: ((#odpsProject=='PX_BEIJING_TEST')).	((#odpsProject=='PX_BEIJING_TEST'))
NotificationServices	array<object>	No	Las configuraciones del servicio de notificación.
	object	No	Un servicio de notificación.
Channel	string	No	El canal de notificación. Valores válidos: Mail Sms DingRobot Weixin	Mail
Extension	string	No	Información adicional en formato JSON. Por ejemplo, utilice {"atAll":"true"} para especificar si se debe notificar a todos los miembros.	{"atAll":"true"}
Receiver	string	No	La URL del webhook. Este parámetro es obligatorio cuando `Channel` se establece en `DingRobot` o `Weixin`.	https://dingtalk.com
ApprovalNodes	array<object>	No	Una lista de nodos de aprobación. Este parámetro no se aplica a las políticas del sistema.
	array<object>	No	Un nodo de aprobación.
Name	string	No	El nombre del nodo.	default-name
AccountType	string	No	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`: El propietario de una tabla. `TableOrProjectAdministrator`: El administrador de la tabla o del espacio de trabajo. `AliyunResourceOwner`: Una cuenta de Alibaba Cloud. `MaxComputeRole`: Un administrador 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.	TableOrProjectAdministrator
Assignees	string	No	Especifica los aprobadores. El valor obligatorio depende de `AccountType`: Si `AccountType` es `DataWorksProjectMember`, este parámetro especifica los ID de usuario de los miembros del espacio de trabajo. Si `AccountType` es `DataWorksProjectRole`, este parámetro especifica los códigos de los roles del espacio de trabajo. Si `AccountType` es `MaxComputeRole`, este parámetro especifica los roles de MaxCompute. Si `AccountType` es `TenantRole`, este parámetro especifica los códigos de los roles de inquilino. Si `AccountType` es `AliyunRamUser`, este parámetro especifica los ID de usuario de los usuarios de RAM.	DataWorksProjectMember
ExtensionProperties	object	No	Propiedades adicionales que son obligatorias para valores específicos de `AccountType`: Si `AccountType` es `DataWorksProjectMember`: La clave es `projectId` y el valor es el ID de usuario de un miembro del espacio de trabajo. Utilice comas (,) para separar varios ID de usuario. Si `AccountType` es `MaxComputeRole`: La clave es el nombre del proyecto de MaxCompute y el valor es el nombre del rol en MaxCompute. Utilice comas (,) para separar varios nombres de rol.
	any	No	Propiedades adicionales.	{ "449656": "role_project_admin,role_project_pe" }
ClientToken	string	No	El parámetro idempotente. Garantiza que las solicitudes reintentadas no den lugar a operaciones duplicadas.	1AFAE64E-D1BE-432B-A9****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El código de error devuelto en la respuesta de la API. Este valor no está vacío si la llamada falla.
RequestId	string	El ID de la solicitud.	0bc5df3a17****903790e8e8a

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "0bc5df3a17****903790e8e8a"
}

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.