All Products
Search
Document Center

DataWorks:ListDataServiceGroups

Last Updated:Jul 31, 2026

Queries the list of Data Service business processes.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

PageNumber

integer

No

The page number. Pages start from 1. Default value: 1.

1

PageSize

integer

No

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

10

ProjectId

integer

Yes

The workspace ID.

You can obtain this value from PageResult.ProjectList[].ProjectId in the response of the ListProjects operation.

10000

TenantId

integer

No

[Deprecated] The tenant ID.

10001

GroupNameKeyword

string

No

The keyword of the business process name. Fuzzy match is supported.

TestBusinessProcess

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID. A unique identifier for the request.

0000-ABCD-EF****

GroupPagingResult

object

The pagination result of business processes.

PageNumber

integer

The page number, which is the same as the PageNumber value in the request.

1

PageSize

integer

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

10

TotalCount

integer

The total number of records.

100

Groups

array<object>

The list of business processes.

object

ModifiedTime

string

The time when the business process was modified.

2020-09-24T18:37:51+0800

Description

string

The description of the business process.

Workflow description

GroupName

string

The name of the business process.

Workflow name

GroupId

string

The business process ID.

ds_123abc

ProjectId

integer

The workspace ID.

10002

ApiGatewayGroupId

string

The ID of the API Gateway group to which the workflow is bound.

100abc

CreatorId

string

The user identifier (UID) of the creator of the business process. The value of this parameter may be empty for creators of some existing business processes.

10001

CreatedTime

string

The time when the business process was created.

2020-09-24T18:37:51+0800

TenantId

integer

The tenant ID.

10003

Examples

Success response

JSON format

{
  "RequestId": "0000-ABCD-EF****",
  "GroupPagingResult": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 100,
    "Groups": [
      {
        "ModifiedTime": "2020-09-24T18:37:51+0800",
        "Description": "Workflow description",
        "GroupName": "Workflow name",
        "GroupId": "ds_123abc",
        "ProjectId": 10002,
        "ApiGatewayGroupId": "100abc",
        "CreatorId": "10001",
        "CreatedTime": "2020-09-24T18:37:51+0800",
        "TenantId": 10003
      }
    ]
  }
}

Error codes

HTTP status code

Error code

Error message

Description

500 InternalError.System An internal system error occurred. Try again later.
500 InternalError.UserId.Missing An internal system error occurred. Try again later.
403 Forbidden.Access Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. No permission, please authorize
429 Throttling.Api The request for this resource has exceeded your available limit.
429 Throttling.System The DataWorks system is busy. Try again later.
429 Throttling.User Your request is too frequent. Try again later.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.