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

Crea una nueva definición de proceso de aprobación y admite la configuración personalizada de reglas de aprobación y servicios de notificación.

Descripción de la operación

Notas de uso

Esta operación de API permite crear una nueva definición de proceso de aprobación, incluida la configuración de información básica, como el nombre, la descripción, el tipo y el subtipo de la política de aprobación.
Puede definir una lista de reglas de condición (RuleConditions) para especificar las condiciones que activan el proceso de aprobación.
Se pueden configurar varios servicios de notificación (NotificationServices) para enviar notificaciones al personal relevante en diferentes etapas del proceso de aprobación.
La lista de nodos de aprobación (ApprovalNodes) define los nodos que se deben recorrer durante el proceso de aprobación y la información del aprobador para cada nodo.
Puede elegir si se debe habilitar inmediatamente la definición de proceso de aprobación recién creada.
Nota: Ciertos campos, como Type, tienen restricciones de valor específicas. Consulte las descripciones de las restricciones en la documentación.

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

create

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Name	string	Sí	El nombre de la definición de proceso.	My Approval Policy
Description	string	Sí	La descripción de la definición de proceso.	This is a sample policy
Type	string	No	El tipo de la definición de proceso. Valores válidos: MaxCompute DataService Extension Hologres	Extension
SubType	string	No	El subtipo. Valores válidos: Table Column Database Schema Default	Table
Enabled	boolean	No	Especifica si se debe habilitar la definición de proceso.
RuleConditions	array<object>	Sí	La lista de reglas de condición.
	object	No	La regla.
Type	string	No	El tipo de condición. Valores válidos: `odpsProject` `hologresInstanceId` `sensibleLevel` `tableGuid` `projectId`	odpsProject
Scope	string	No	La etapa en la que la regla surte efecto: `Deployment`: se usa para determinar si la política de aprobación coincide cuando se envía una solicitud. `Running`: se usa para determinar si se exime de aprobación durante la ejecución del proceso de aprobación. Este valor se admite solo para el tipo MaxCompute.	Deployment
Expression	string	No	La expresión de condición con el formato ((#type=='typeValue')). Ejemplo: ((#odpsProject=='PX_BEIJING_TEST')).	((#odpsProject=='PX_BEIJING_TEST'))
NotificationServices	array<object>	No	Las declaraciones de servicios de notificación.
	object	No	La declaración de servicio de notificación.
Channel	string	No	El canal de notificación. Valores válidos: Mail Sms DingRobot Weixin	DingRobot
Extension	string	No	La información de extensión en formato JSON. Ejemplo: `{"atAll":"true"}`, que especifica si se debe mencionar a todos los miembros.	{"atAll":"true"}
Receiver	string	No	La WebhookUrl que se debe especificar cuando Channel se establece en DingRobot o Weixin.	https://dingtalk.com
ApprovalNodes	array<object>	Sí	La lista de nodos de aprobación.
	array<object>	No	El nodo.
Name	string	No	El nombre del nodo.	default-name
AccountType	string	No	El tipo de aprobador del nodo: DataWorksProjectRole: rol de espacio de trabajo. DataWorksProjectMember: miembro del espacio de trabajo. TableAdministrator: propietario de la tabla. TableOrProjectAdministrator: administrador de tabla o de espacio de trabajo. AliyunResourceOwner: cuenta de Alibaba Cloud. MaxComputeRole: rol de MaxCompute. DLFAdmin: administrador de DLF Legacy. DLFNextAdmin: administrador de DLF Next. TenantRole: rol de inquilino. EmrAdministrator: administrador de EMR. LindormAdministrator: administrador de Lindorm. AliyunRamUser: usuario de RAM.	TableOrProjectAdministrator
Assignees	array	No	La semántica de este parámetro varía según el valor de AccountType: DataWorksProjectMember: el ID de usuario del miembro del espacio de trabajo. DataWorksProjectRole: el código del rol de espacio de trabajo. Si se requiere un rol de espacio de trabajo personalizado, establezca este parámetro en "custom-role" y configure el rol en ExtensionProperties. MaxComputeRole: el rol de MaxCompute. TenantRole: el código del rol de inquilino. AliyunRamUser: el ID de usuario de RAM.
	string	No	El aprobador.	213463068144525171
ExtensionProperties	object	No	Las declaraciones adicionales requeridas según el valor de AccountType: DataWorksProjectMember: especifique diferentes ID de usuario de miembros del espacio de trabajo. La clave es el ID del espacio de trabajo y el valor es el ID de usuario del miembro del espacio de trabajo. Separe varios ID de usuario con comas (,). DataWorksProjectRole: especifique diferentes códigos de roles de espacio de trabajo personalizados. La clave es el ID del espacio de trabajo y el valor es el código del rol de espacio de trabajo personalizado. Separe varios códigos de rol con comas (,). MaxComputeRole: especifique los roles de un proyecto de MaxCompute. La clave es el nombre del proyecto de MaxCompute y el valor es el nombre del rol en MaxCompute. Separe varios nombres de rol con comas (,).
	any	No	La descripción de la extensión.	{ "449656": "role_project_admin,role_project_pe" }
ClientToken	string	No	El token de idempotencia. Se recomienda usar un UUID.	0000-ABCD-EFG****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El esquema de respuesta.
RequestId	string	El ID de la solicitud.	0bc5df3a17***903790e8e8a
Id	string	El ID de la definición de proceso.	1010543619

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "0bc5df3a17***903790e8e8a",
  "Id": "1010543619"
}

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.