Crea una definición de flujo de trabajo.
Pruébelo ahora
Test
Autorización de RAM
|
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.