All Products
Search
Document Center

DataWorks:ListBaselineStatuses

Last Updated:Oct 17, 2024

Queries a list of baseline instances.

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
PageNumberintegerYes

The number of the page to return. Valid values: 1 to 30. Default value: 1.

1
PageSizeintegerYes

The number of entries to return on each page. Default value: 10. Maximum value: 100.

10
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
PrioritystringNo

The priority of the baseline. Valid values: 1, 3, 5, 7, and 8. Multiple priorities are separated by commas (,).

1,3,5,7,8
SearchTextstringNo

The keyword of the baseline name used to search for the baseline.

Keyword of the baseline name
OwnerstringNo

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

9527952795****
TopicIdlongNo

The ID of the event.

1234
FinishStatusstringNo

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. Multiple states are separated by commas (,).

FINISH,UNFINISH
StatusstringNo

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. Multiple states are separated by commas (,).

SAFE,DANGROUS,OVER
BaselineTypesstringNo

The type of the baseline. Valid values: DAILY and HOURLY. The value DAILY indicates that the baseline is scheduled by day. The value HOURLY indicates that the baseline is scheduled by hour. Multiple types are separated by commas (,).

DAILY,HOURLY

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

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.

Invalid.Tenant.ConnectionNotExists
Successboolean

Indicates whether the request was successful.

true
Dataobject

The data returned.

PageNumberinteger

The page number of the returned page.

1
PageSizeinteger

The number of entries returned per page.

10
TotalCountinteger

The total number of baseline instances.

100
BaselineStatusesarray<object>

The list of baseline instances.

BaselineStatusesobject
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 are run before the alert duration begins. The value DANGEROUS indicates that nodes are still running after the alert duration ends but the committed completion time does not arrive. 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.

1553531400000
ProjectIdlong

The ID of the workspace to which the baseline belongs.

1234
Priorityinteger

The priority of the baseline. Valid values: {1,3,5,7,8}.

1
EndCastlong

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

1553531400000
InGroupIdinteger

The ID of the cycle of the baseline instance. Valid values of the ID of an hour-level cycle: [1,24]. The ID of a day-level cycle is 1.

1
BaselineNamestring

The name of the baseline.

Baseline name
BaselineIdlong

The baseline ID.

1234
FinishStatusstring

The status of the baseline instance. Valid values: UNFINISH and FINISH.

UNFINISH
Bizdatelong

The data timestamp.

1553443200000
Bufferlong

The margin of the baseline instance. Unit: seconds.

1800
SlaTimelong

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

1553531400000
ExpTimelong

The timestamp of the alerting time of the baseline instance.

1553531400000

Examples

Sample success responses

JSONformat

{
  "HttpStatusCode": 200,
  "RequestId": "0000-ABCD-EFG****",
  "ErrorMessage": "The specified parameters are invalid.",
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Success": true,
  "Data": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 100,
    "BaselineStatuses": [
      {
        "Status": "SAFE",
        "Owner": "9527952795****",
        "FinishTime": 1553531400000,
        "ProjectId": 1234,
        "Priority": 1,
        "EndCast": 1553531400000,
        "InGroupId": 1,
        "BaselineName": "Baseline name\n",
        "BaselineId": 1234,
        "FinishStatus": "UNFINISH",
        "Bizdate": 1553443200000,
        "Buffer": 1800,
        "SlaTime": 1553531400000,
        "ExpTime": 1553531400000
      }
    ]
  }
}

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