All Products
Search
Document Center

DataWorks:GetBusiness

Last Updated:Jan 12, 2026

Queries the information about a workflow.

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
ProjectIdlongNo

The DataWorks workspace ID. You can log on to the DataWorks console and go to the Workspace page to query the ID. You must specify either this parameter or the ProjectIdentifier parameter to identify the DataWorks workspace when you call this operation.

10000
ProjectIdentifierstringNo

The name of the DataWorks workspace. You can log on to the DataWorks console and go to the Workspace page to query the workspace name. You must specify either this parameter or the ProjectId parameter to identify the DataWorks workspace when you call this operation.

dw_project
BusinessIdlongYes

The workflow ID. You can call the ListBusiness operation to obtain the folder ID.

1000000111

Response parameters

ParameterTypeDescriptionExample
object

Responses.

HttpStatusCodeinteger

The HTTP status code.

200
ErrorMessagestring

The error message.

The connection does not exist.
RequestIdstring

The request ID. Used for troubleshooting when an error occurs.

0000-ABCD-EFG****
ErrorCodestring

The error code.

Invalid.Tenant.ConnectionNotExists
Successboolean

Indicates whether the call was successful. Valid values:

  • true: success.
  • false: failure.
true
Dataobject

Details of the workflow.

Ownerstring

The Alibaba Cloud account ID of the workflow owner.

20000****
Descriptionstring

The description of the workflow.

This is my first business process.
ProjectIdstring

The ID of the workspace where the workflow resides.

10000
BusinessIdlong

The workflow ID.

1000001
BusinessNamestring

The name of the workflow. Workflow names must be unique within the same workspace.

The first business process
UseTypestring

The functional module to which the workflow belongs. Valid values: NORMAL (Data Studio) and MANUAL_BIZ (Manually Triggered Workflow)

NORMAL

Examples

Sample success responses

JSONformat

{
  "HttpStatusCode": 200,
  "ErrorMessage": "The connection does not exist.",
  "RequestId": "0000-ABCD-EFG****",
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Success": true,
  "Data": {
    "Owner": "20000****",
    "Description": "This is my first business process.",
    "ProjectId": 10000,
    "BusinessId": 1000001,
    "BusinessName": "The first business process",
    "UseType": "NORMAL"
  }
}

Error codes

HTTP status codeError codeError messageDescription
403Forbidden.AccessAccess is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition.No permission, please authorize
429Throttling.ApiThe request for this resource has exceeded your available limit.-
429Throttling.SystemThe DataWorks system is busy. Try again later.-
429Throttling.UserYour request is too frequent. Try again later.-
500InternalError.SystemAn internal system error occurred. Try again later.-
500InternalError.UserId.MissingAn internal system error occurred. Try again later.-

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