All Products
Search
Document Center

DataWorks:GetBaselineStatus

Last Updated:Nov 21, 2024

Queries the details of a baseline instance.

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
BaselineIdlongYes

The ID of the baseline.

1234
BizdatestringYes

The data timestamp of the baseline instance. Specify the time in the ISO 8601 standard in the yyyy-MM-dd'T'HH:mm:ssZ format. The time must be in UTC.

2020-07-07T00:00:00+0800
InGroupIdintegerYes

The ID of the scheduling cycle of the baseline instance. For a baseline instance that is scheduled by day, the value of this parameter is 1. For a baseline instance that is scheduled by hour, the value of this parameter ranges from 1 to 24.

1

Response parameters

ParameterTypeDescriptionExample
object
HttpStatusCodeinteger

The HTTP status code returned.

200
RequestIdstring

The ID of the request. You can use the ID to troubleshoot issues.

0000-ABCD-EFG****
ErrorMessagestring

The error message returned.

The specified parameters are invalid.
ErrorCodestring

The error code returned.

1031203110005
Successboolean

Indicates whether the request was successful.

true
Dataobject

The details of the baseline instance.

Statusstring

The status of the baseline. Valid values: ERROR, SAFE, DANGEROUS, and OVER. The value ERROR indicates that no nodes are associated with the baseline, or all nodes associated with the baseline are suspended. The value SAFE indicates that nodes finish running before the alerting time. The value DANGEROUS indicates that nodes are still running after the alerting time but before the committed completion time. The value OVER indicates that nodes are still running after the committed completion time.

SAFE
Ownerstring

The ID of the Alibaba Cloud account used by the baseline owner. Multiple IDs are separated by commas (,).

9527952795****
FinishTimelong

The timestamp of the actual time when the baseline instance finished running. This parameter is returned if the value of the FinishStatus parameter is FINISH.

1553443200000
ProjectIdlong

The ID of the workspace to which the baseline belongs.

1234
Priorityinteger

The priority of the baseline. Valid values: 1, 2, 5, 7, and 8.

1
EndCastlong

The timestamp of the predicted time when the baseline instance finished running.

1553443200000
InGroupIdinteger

The ID of the scheduling cycle of the baseline instance. For a baseline instance that is scheduled by day, the value of this parameter is 1. For a baseline instance that is scheduled by hour, the value of this parameter ranges from 1 to 24.

1
BaselineNamestring

The name of the baseline.

Baseline name
BaselineIdlong

The ID of the baseline.

1234
FinishStatusstring

The status of the baseline instance. Valid values: UNFINISH and FINISH. The value UNFINISH indicates that the baseline instance is still running. The value FINISH indicates that the baseline instance finishes running.

UNFINISH
Bizdatelong

The data timestamp of the baseline instance.

1553443200000
Bufferfloat

The margin of the baseline instance. Unit: seconds.

1200
SlaTimelong

The timestamp of the committed completion time of the baseline instance.

1553443200000
ExpTimelong

The timestamp of the alerting time of the baseline instance.

1553443200000
LastInstanceobject

The information about the last generated instance.

Statusstring

The status of the instance. Valid values: NOT_RUN, WAIT_TIME, WAIT_RESOURCE, RUNNING, CHECKING, CHECKING_CONDITION, FAILURE, and SUCCESS. The value NOT_RUN indicates that the instance is not run. The value WAIT_TIME indicates that the instance is waiting to be run. The value WAIT_RESOURCE indicates that the instance is waiting for resources. The value RUNNING indicates that the instance is running. The value CHECKING indicates that data quality is being checked for the instance. The value CHECKING_CONDITION indicates that branch conditions are being checked for the instance. The value FAILURE indicates that the instance fails to run. The value SUCCESS indicates that the instance is run.

SUCCESS
Ownerstring

The ID of the Alibaba Cloud account used by the node owner.

9527952795****
FinishTimelong

The timestamp of the actual time when the instance finished running.

1553443200000
NodeNamestring

The name of the node.

Node name
ProjectIdlong

The ID of the workspace to which the node belongs.

1234
InstanceIdlong

The ID of the instance.

12345
EndCastlong

The timestamp of the predicted time when the instance finished running.

1553443200000
NodeIdlong

The ID of the node.

1234
BlockInstanceobject

The information about the key instance.

Statusstring

The status of the instance. Valid values: NOT_RUN, WAIT_TIME, WAIT_RESOURCE, RUNNING, CHECKING, CHECKING_CONDITION, FAILURE, and SUCCESS. The value NOT_RUN indicates that the instance is not run. The value WAIT_TIME indicates that the instance is waiting to be run. The value WAIT_RESOURCE indicates that the instance is waiting for resources. The value RUNNING indicates that the instance is running. The value CHECKING indicates that data quality is being checked for the instance. The value CHECKING_CONDITION indicates that branch conditions are being checked for the instance. The value FAILURE indicates that the instance fails to run. The value SUCCESS indicates that the instance is run.

SUCCESS
Ownerstring

The ID of the Alibaba Cloud account used by the node owner.

9527952795****
FinishTimelong

The timestamp of the actual time when the instance finished running.

1553443200000
NodeNamestring

The name of the node.

Node name
ProjectIdlong

The ID of the workspace to which the node belongs.

1234
InstanceIdlong

The ID of the instance.

12345
EndCastlong

The timestamp of the predicted time when the instance finished running.

1553443200000
NodeIdlong

The ID of the node.

1234

Examples

Sample success responses

JSONformat

{
  "HttpStatusCode": 200,
  "RequestId": "0000-ABCD-EFG****",
  "ErrorMessage": "The specified parameters are invalid.",
  "ErrorCode": "1031203110005",
  "Success": true,
  "Data": {
    "Status": "SAFE",
    "Owner": "9527952795****",
    "FinishTime": 1553443200000,
    "ProjectId": 1234,
    "Priority": 1,
    "EndCast": 1553443200000,
    "InGroupId": 1,
    "BaselineName": "Baseline name\n",
    "BaselineId": 1234,
    "FinishStatus": "UNFINISH",
    "Bizdate": 1553443200000,
    "Buffer": 1200,
    "SlaTime": 1553443200000,
    "ExpTime": 1553443200000,
    "LastInstance": {
      "Status": "SUCCESS",
      "Owner": "9527952795****",
      "FinishTime": 1553443200000,
      "NodeName": "Node name\n",
      "ProjectId": 1234,
      "InstanceId": 12345,
      "EndCast": 1553443200000,
      "NodeId": 1234
    },
    "BlockInstance": {
      "Status": "SUCCESS",
      "Owner": "9527952795****",
      "FinishTime": 1553443200000,
      "NodeName": "Node name\n",
      "ProjectId": 1234,
      "InstanceId": 12345,
      "EndCast": 1553443200000,
      "NodeId": 1234
    }
  }
}

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.Api.RiskThe request for this resource has exceeded your daily available limit.-
429Throttling.SystemThe DataWorks system is busy. Try again later.-
429Throttling.UserYour request is too frequent. Try again later.-
500Forbidden.Not.ServerThe dataworksAPI service is not available in this area. Please try it in another area.-
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.

Change history

Change timeSummary of changesOperation
No change history