创建基线,如需使用告警,需要使用 UpdateBaseline 接口配置。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateBaseline

系统规定参数。取值:CreateBaseline

BaselineName String BaselineName

基线名称。

ProjectId Long 10000

DataWorks工作空间的ID,您可以登录DataWorks控制台,进入工作空间管理页面查看ID。

Owner String 1000000000001

基线责任人的阿里云uid。

Priority Integer 1,3,5,7,8

基线的优先级,取值范围为{1,3,5,7,8}。

NodeIds String 210001233239,210001236482

基线上游节点列表。

OvertimeSettings.N.Cycle Integer 1

承诺时间对应的周期,天基线需要配置为1,小时基线可以配置最多24个周期。

OvertimeSettings.N.Time String 00:00

承诺时间,hh:mm格式,hh的取值范围为[0,47],mm的取值范围为[0,59]。

AlertMarginThreshold Integer 30

基线预警余量,单位为分钟。

BaselineType String DAILY

基线类型,包括DAILY(天基线)和HOURLY(小时基线)。

返回数据

名称 类型 示例值 描述
Success Boolean true

调用是否成功。取值如下:

  • true:调用成功。
  • false:调用失败。
ErrorCode String 401

错误码。

ErrorMessage String The specified parameters are invalid.

错误信息。

HttpStatusCode Integer 200

HTTP返回码。

Data Long 100003

基线的id。

RequestId String F05080B0-CCE6-5D22-B284-34A51C5D4E28

本次调用请求的ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateBaseline
&BaselineName=BaselineName
&ProjectId=10000
&Owner=1000000000001
&NodeIds=210001233239,210001236482
&OvertimeSettings=[{"Cycle":1,"Time":"00:00"}]
&AlertMarginThreshold=30
&BaselineType=DAILY
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateBaselineResponse>
    <Success>true</Success>
    <ErrorCode>401</ErrorCode>
    <ErrorMessage>The specified parameters are invalid.</ErrorMessage>
    <HttpStatusCode>200</HttpStatusCode>
    <Data>100003</Data>
    <RequestId>F05080B0-CCE6-5D22-B284-34A51C5D4E28</RequestId>
</CreateBaselineResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Success" : true,
  "ErrorCode" : "401",
  "ErrorMessage" : "The specified parameters are invalid.",
  "HttpStatusCode" : 200,
  "Data" : 100003,
  "RequestId" : "F05080B0-CCE6-5D22-B284-34A51C5D4E28"
}

错误码

访问错误中心查看更多错误码。