GetWorkflow - 获取工作流的基本信息

获取工作流的基本信息

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ClusterIdstring

集群 ID。

xxljob-b6ec1xxxx
AppNamestring

应用名称。

xxl-job-executor-sample
WorkflowIdlong

工作流 ID

20

返回参数

名称类型描述示例值
object

Schema of Response

Codeinteger

响应码。

200
Messagestring

错误信息。

Parameter error: content is null.
RequestIdstring

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

27B1345D-5F71-5972-8E4C-AABA6C6232F0
Successboolean

是否调用成功。

  • true:调用成功。
  • false:调用失败。
true
Dataobject
WorkflowIdlong

工作流 ID

10
Namestring

工作流名称

myWorkflow
Descriptionstring

工作流描述

my first workflow
Statusinteger

工作流状态

  • 0:禁用
  • 1:启用
2
MaxConcurrencyinteger

最大并发数。

100
TimeTypeinteger

调度类型:

  • -1: none
  • 1:cron
  • 100::api
1
TimeExpressionstring

时间表达式,根据选择的时间类型设置时间表达式。

  • none:无需填写
  • cron:填写标准的 cron 表达式,支持在线验证。
  • api:无需填写
0 0 12 * * ?
Timezonestring

时区

说明 默认使用当前 region 服务器所在时区
GMT+8
Calendarstring

自定义日历

workday
Creatorstring

创建人。

18582193685027xx
Updaterstring

更新人。

18582193685027xx
Xattrsstring

扩展属性。

说明 暂不支持
null
AppNamestring

应用名称。

test-app

示例

正常返回示例

JSON格式

{
  "Code": 200,
  "Message": "Parameter error: content is null.",
  "RequestId": "27B1345D-5F71-5972-8E4C-AABA6C6232F0",
  "Success": true,
  "Data": {
    "WorkflowId": 10,
    "Name": "myWorkflow",
    "Description": "my first workflow",
    "Status": 2,
    "MaxConcurrency": 100,
    "TimeType": 1,
    "TimeExpression": "0 0 12 * * ?",
    "Timezone": "GMT+8",
    "Calendar": "workday",
    "Creator": "18582193685027xx",
    "Updater": "18582193685027xx",
    "Xattrs": null,
    "AppName": "test-app"
  }
}

错误码

HTTP status code错误码错误信息描述
400InvalidParameterParameter error: %s.参数错误: %s
401IllegalRequestIllegalRequest: %s.非法请求:%s
403NoPermissionNo permission to perform this operation: %s.没有权限去执行该操作:%s
404NotFoundNot found: %s.资源不存在:%s
500InternalErrorInternalError: %s.系统内部错误:%s

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2025-12-25新增 OpenAPI查看变更详情