All Products
Search
Document Center

DataWorks:ListDeployments

Last Updated:Dec 12, 2024

Queries a list of processes that are used to deploy or undeploy entities in DataStudio. You can also specify filter conditions to query specific processes.

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
CreatorstringNo

The ID of the user who creates the processes. This parameter specifies a filter condition.

110755000425XXXX
StatusstringNo

The status of the processes. This parameter specifies a filter condition.

Valid values:

  • INIT
  • RUNNING
  • SUCCESS
  • FAIL
  • TERMINATION
  • CANCEL
Enumeration Value:
  • Init: Init.
  • Cancel: Cancel.
  • Running: Running.
  • Termination: Termination.
  • Success: Success.
  • Fail: Fail.
RUNNING
PageNumberintegerNo

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

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.

7C352CB7-CD88-50CF-9D0D-E81BDF02XXXX
PagingInfoobject

The pagination information.

TotalCountstring

The total number of entries returned.

2524
PageSizestring

The number of entries per page.

10
PageNumberstring

The page number.

1
Deploymentsarray<object>

The deployment processes.

deloymentobject

The information about the process.

Idstring

The process ID.

ddf354a5-03df-48fc-94c1-cc973f79XXXX
ProjectIdstring

The DataWorks workspace ID.

44683
CreateTimelong

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

1702736654000
ModifyTimelong

The time when the process was last modified. This value is a UNIX timestamp.

1702736654000
Creatorstring

The ID of the user who creates the process.

110755000425XXXX
Statusstring

The status of the process.

Valid values:

  • Init
  • Running
  • Success
  • Fail
  • Termination
  • Cancel
RUNNING
Messagestring

The error message returned if the process fails.

Stagesarray<object>

The stages of the process.

stageobject

The information about the stage.

Codestring

The code of the stage.

DEV_CHECK
Stepinteger

The step number of the stage.

1
Typestring

The type of the stage. This parameter indicates the operation type in the stage.

Valid values:

  • Deploy
  • Check
  • Offline
  • Build
  • Delete
CHECK
Namestring

The name of the stage.

Descriptionstring

The description of the stage.

Messagestring

The error message returned during the stage.

Statusstring

The status of the stage.

Valid values:

  • Init
  • Running
  • Success
  • Fail
  • Termination
  • Cancel
RUNNING
Detailobject

The additional information about the stage.

any

The additional information.

Examples

Sample success responses

JSONformat

{
  "RequestId": "7C352CB7-CD88-50CF-9D0D-E81BDF02XXXX",
  "PagingInfo": {
    "TotalCount": "2524",
    "PageSize": "10",
    "PageNumber": "1",
    "Deployments": [
      {
        "Id": "ddf354a5-03df-48fc-94c1-cc973f79XXXX\n",
        "ProjectId": "44683",
        "CreateTime": 1702736654000,
        "ModifyTime": 1702736654000,
        "Creator": "110755000425XXXX",
        "Status": "RUNNING",
        "Message": "",
        "Stages": [
          {
            "Code": "DEV_CHECK",
            "Step": 1,
            "Type": "CHECK",
            "Name": "",
            "Description": "",
            "Message": "",
            "Status": "RUNNING",
            "Detail": {
              "key": ""
            }
          }
        ]
      }
    ]
  }
}

Error codes

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

Change history

Change timeSummary of changesOperation
No change history