All Products
Search
Document Center

DataWorks:ListWorkflowDefinitions

Last Updated:Dec 12, 2024

Queries a list of workflows in DataStudio. You can also specify filter conditions to query specific workflows.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
ProjectIdstringYes

The DataWorks workspace ID. You can log on to the DataWorks console and go to the Workspace page to query the ID.

You must configure this parameter to specify the DataWorks workspace to which the API operation is applied.

10000
TypestringNo

The workflow type. This parameter specifies a filter condition.

Valid values:

  • CycleWorkflow
  • ManualWorkflow
CycleWorkflow
OwnerstringNo

The ID of the Alibaba Cloud account used by the workspace administrator. You can log on to the Alibaba Cloud Management Console and view the ID on the Security Settings page.

110755000425XXXX
PageNumberintegerNo

The page number.

1
PageSizeintegerNo

The number of entries per page. Default value: 10. Maximum value: 100.

10

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The request ID.

8C3ED0C5-ABAB-55E1-854B-DAC02B11XXXX
PagingInfoobject

The pagination information.

TotalCountinteger

The total number of entries returned.

227
PageSizeinteger

The number of entries per page.

10
PageNumberinteger

The page number.

1
WorkflowDefinitionsarray<object>

The workflows.

workflowDefinitionobject
ProjectIdstring

The ID of the DataWorks workspace to which the workflow belongs.

4710
Ownerstring

The owner.

110755000425XXXX
CreateTimelong

The time when the workflow was created. This value is a UNIX timestamp.

1698057323000
ModifyTimelong

The times when the workflow was last modified. This value is a UNIX timestamp.

1698057323000
Descriptionstring

The description of the workflow.

Typestring

The type of the workflow.

Valid values:

  • CycleWorkflow
  • ManualWorkflow
CycleWorkflow
Scriptobject

The script information.

Pathstring

The script path.

Runtimeobject

The runtime.

Commandstring

The command.

WORKFLOW
Idstring

The script ID.

698002781368644XXXX
Idstring

The ID of the workflow.

463497880880954XXXX
Namestring

The name of the workflow.

Examples

Sample success responses

JSONformat

{
  "RequestId": "8C3ED0C5-ABAB-55E1-854B-DAC02B11XXXX",
  "PagingInfo": {
    "TotalCount": 227,
    "PageSize": 10,
    "PageNumber": 1,
    "WorkflowDefinitions": [
      {
        "ProjectId": "4710",
        "Owner": "110755000425XXXX",
        "CreateTime": 1698057323000,
        "ModifyTime": 1698057323000,
        "Description": "",
        "Type": "CycleWorkflow",
        "Script": {
          "Path": "",
          "Runtime": {
            "Command": "WORKFLOW"
          },
          "Id": "698002781368644XXXX"
        },
        "Id": "463497880880954XXXX",
        "Name": ""
      }
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history