Todos los productos
Search
Centro de documentos

E-MapReduce:CreateProcessDefinitionWithSchedule

Última actualización: Oct 28, 2026

Crea una definición de flujo de trabajo.

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

emr-serverless-spark:CreateProcessDefinitionWithSchedule

none

*Todos los recursos.

*

Ninguna Ninguna

Sintaxis de la solicitud

POST /dolphinscheduler/projects/{bizId}/process-definition HTTP/1.1

Parámetros de ruta

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

bizId

string

Sí

El ID del espacio de trabajo.

w-d8********

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

productNamespace

string

Sí

El código del producto.

SS

name

string

Sí

El nombre del flujo de trabajo.

ods_batch_workflow

description

string

Sí

La descripción del flujo de trabajo.

ods batch workflow

timeout

integer

No

El período de tiempo de espera predeterminado para la ejecución del flujo de trabajo, en segundos.

60

taskRelationJson

array<object>

Sí

El arreglo JSON de dependencias de tareas. Contiene las dependencias entre todas las tareas del flujo de trabajo. preTaskCode especifica el ID de la tarea ascendente, y postTaskCode especifica el ID de la tarea descendente. Cada tarea debe tener un ID único. Si un nodo de tarea no tiene una tarea ascendente, debe agregar una dependencia con preTaskCode establecido en 0.

object

Sí

El objeto JSON de dependencias de tareas. Contiene las dependencias entre todas las tareas del flujo de trabajo. preTaskCode especifica el ID de la tarea ascendente, y postTaskCode especifica el ID de la tarea descendente. Cada tarea debe tener un ID único. Si un nodo de tarea no tiene una tarea ascendente, debe agregar una dependencia con preTaskCode establecido en 0.

name

string

Sí

El nombre de la relación de topología de tareas. Establezca este parámetro con el nombre del flujo de trabajo.

ods batch workflow

preTaskCode

integer

Sí

El ID de la tarea ascendente.

16************

preTaskVersion

integer

Sí

La versión de la tarea ascendente.

1

postTaskCode

integer

Sí

El ID de la tarea descendente.

28************

postTaskVersion

integer

Sí

La versión de la tarea descendente.

1

taskDefinitionJson

array<object>

Sí

El arreglo JSON de definiciones de tareas. Contiene la información de descripción de todas las tareas del flujo de trabajo.

array<object>

Sí

El objeto JSON de definiciones de tareas. Contiene la información de descripción de todas las tareas del flujo de trabajo.

code

integer

Sí

El ID de la definición de tarea.

36************

description

string

No

La descripción de la definición de tarea.

ods transform task

alertEmailAddress

string

No

La dirección de correo electrónico para las notificaciones de alertas.

foo_bar@spark.alert.invalid.com

startAlertEnable

boolean

No

Especifica si se deben habilitar las alertas para el inicio de la tarea.

false

failAlertEnable

boolean

No

Especifica si se deben habilitar las alertas para los fallos de la tarea.

false

failRetryTimes

integer

No

El número de reintentos después de que una tarea falla.

1

name

string

Sí

El nombre de la tarea.

ods_transform_task

taskParams

object

Sí

Los parámetros de definición de la tarea.

workspaceBizId

string

Sí

El ID del espacio de trabajo.

w-d8********

taskBizId

string

Sí

El ID de la tarea de desarrollo de datos.

TSK-d87******************

resourceQueueId

string

Sí

La cola de recursos para ejecutar la tarea de Spark.

root_queue

sparkDriverCores

integer

No

El número de núcleos para el controlador de Spark.

1

sparkExecutorCores

integer

No

El número de núcleos para el ejecutor de Spark.

1

sparkDriverMemory

integer

No

El tamaño de memoria para el controlador de Spark.

4g

sparkExecutorMemory

integer

No

El tamaño de memoria para el ejecutor de Spark.

4g

sparkConf

array<object>

No

Las configuraciones de la tarea de Spark.

object

No

key

string

No

La clave de la configuración de Spark.

spark.dynamicAllocation.enabled

value

string

No

El valor de la configuración de Spark.

true

sparkVersion

string

No

La versión del motor de base de datos del motor Spark DPI.

esr-4.0.0 (Spark 3.5.2, Scala 2.12)

sparkLogLevel

string

No

El nivel de registro de Spark.

INFO

sparkLogPath

string

No

La ruta de los registros de tareas para el nodo de Spark.

oss://data***/spark/logs

displaySparkVersion

string

No

La versión de visualización del motor de Spark.

esr-4.0.0 (Spark 3.5.2, Scala 2.12)

fusion

boolean

No

Especifica si se debe habilitar la aceleración del motor Fusion.

false

environmentId

string

No

El ID del entorno.

env-crhq2h5lhtgju93buhkg

type

string

No

El tipo de tarea de Spark.

SQL

localParams

array<object>

No

La lista de parámetros locales para la tarea.

object

No

prop

string

No

El nombre del parámetro.

testGlobalParam

direct

string

No

La dirección del parámetro. Valores válidos: IN (entrada) y OUT (salida).

IN

type

string

No

El tipo de datos del parámetro.

VARCHAR

value

string

No

El valor del parámetro.

testGlobalParam

taskType

string

Sí

El tipo de nodo del flujo de trabajo.

EMR_SERVERLESS_SPARK

timeout

integer

No

El período de tiempo de espera para el método de devolución de llamada, en segundos.

1200

tags

object

No

Las etiquetas.

string

No

La cadena JSON de pares clave-valor de etiquetas.

“{\"tagkey\":\"tagvalue\"}”

executionType

string

Sí

La estrategia de ejecución.

PARALLEL

alertEmailAddress

string

No

La dirección de correo electrónico para las notificaciones de alertas.

foo_bar@spark.alert.invalid.com

schedule

object

No

La estructura de programación.

startTime

string

No

La hora de inicio de la programación. Formato: AAAA-MM-DD HH:mm:ss.

2024-12-23 16:13:27

endTime

string

No

La hora de finalización de la programación. Formato: AAAA-MM-DD HH:mm:ss.

2025-12-23 16:13:27

crontab

string

No

La expresión cron para la programación.

0 0 0 * * ?

timezoneId

string

No

El ID de la zona horaria.

Asia/Shanghai

retryTimes

integer

No

El número de reintentos.

1

taskParallelism

integer

No

La concurrencia de tareas.

1

resourceQueue

string

No

La cola de recursos.

root_queue

tags

object

No

Las etiquetas.

string

No

La cadena JSON de pares clave-valor de etiquetas.

“{\"tagkey\":\"tagvalue\"}”

publish

boolean

No

Especifica si se debe publicar el flujo de trabajo.

true

regionId

string

No

El ID de la región.

cn-hangzhou

runAs

string

No

El UID de Alibaba Cloud del usuario de ejecución.

113***************

globalParams

array<object>

No

La lista de parámetros globales para el flujo de trabajo.

object

No

prop

string

No

El nombre del parámetro.

testGlobalParam

value

string

No

El valor del parámetro.

testGlobalParam

direct

string

No

La dirección del parámetro. Valores válidos: IN (entrada) y OUT (salida).

IN

type

string

No

El tipo de datos del parámetro.

VARCHAR

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

Esquema de la respuesta.

requestId

string

El ID de la solicitud.

DD6B1B2A-5837-5237-ABE4-FF0C8944****

code

integer

El código de retorno de la API.

1400009

msg

string

La descripción detallada correspondiente al código de retorno.

No permission for resource action

success

string

Indica si la solicitud se realizó correctamente.

true

failed

string

Indica si la solicitud falló.

false

data

object

El resultado devuelto.

id

integer

El número de definición del flujo de trabajo.

12342

code

integer

El ID de la definición del flujo de trabajo.

160************

httpStatusCode

integer

El código de estado HTTP.

200

Ejemplos

Respuesta exitosa

JSON Formato

{
  "requestId": "DD6B1B2A-5837-5237-ABE4-FF0C8944****",
  "code": 1400009,
  "msg": "No permission for resource action",
  "success": "true",
  "failed": "false",
  "data": {
    "id": 12342,
    "code": 0
  },
  "httpStatusCode": 200
}

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.