全部产品
Search
文档中心

大数据开发治理平台 DataWorks:GetBaseline - 获取基线配置

更新时间:Nov 15, 2024

根据基线ID获取基线配置。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
BaselineIdlong

基线的 ID,可以通过 ListBaselines 获取。

123456
ProjectIdlong

基线所监控的项目空间 ID,可从 ListBaselines 获取。

10000

返回参数

名称类型描述示例值
object

OpenApiResultModel

Successboolean

请求是否成功,true - 成功,false - 失败。

true
ErrorCodestring

错误码。

1031203110005
ErrorMessagestring

错误信息。

The specified parameters are invalid
HttpStatusCodeinteger

HTTP 返回码。

200
Dataobject

返回值。

BaselineIdlong

基线的 id。

1001
BaselineNamestring

基线名。

测试基线
ProjectIdlong

项目 id。

10000
Ownerstring

责任人。

9527952****
Priorityinteger

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

1
BaselineTypestring

基线类型。

  • DAILY - 日基线
  • HOURLY - 小时基线
DAILY
OverTimeSettingsarray<object>

基线承诺时间设置。

OverTimeSettingobject

监控周期。

Cycleinteger

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

1
Timestring

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

00:00
Enabledboolean

是否开启基线。

true
NodeIdsarray

基线上游节点列表。

NodeIdlong

节点 ID。

700003559814
AlertEnabledboolean

是否开启告警。

  • true - 是
  • false - 否
true
AlertMarginThresholdinteger

预警余量,单位为分钟。

60
AlertSettingsarray<object>

告警设置。

AlertSettingobject

基线的告警配置。

AlertTypestring

告警类型

  • BASELINE - 基线
  • TOPIC - 事件
BASELINE
AlertMethodsarray

告警方式列表

AlertMethodstring

告警方式。取值如下:

  • MAIL - 邮件
  • SMS - 短信
  • PHONE - 语音
  • DINGROBOTS - 钉钉机器人
  • WEBHOOKS - Webhook
MAIL
SilenceStartTimestring

静默开始时间,格式为 HH:mm:ss 。

00:00:00
SilenceEndTimestring

静默结束时间,格式为 HH:mm:ss 。

00:00:00
AlertIntervalinteger

事件告警间隔,单位为秒。

900
AlertMaximuminteger

事件告警最大次数。

1
DingRobotsarray<object>

钉钉机器人列表。

DingRobotobject

钉钉机器人配置。

WebUrlstring

钉钉机器人地址。

https://oapi.dingtalk.com/robot/send?access_token=xxx
AtAllboolean

是否 @所有人。

true
Webhooksarray

webhook 列表。

Webhookstring

企业微信或飞书机器人的 webhook 地址,多个 webhook 地址之间使用英文逗号(,)分隔。alertMethods 中需要包含 WEBHOOKS 告警方式。仅 DataWorks 企业版支持。

可用地域:华东 2(上海)、西南 1(成都)、华北 3(张家口)、华北 2(北京)、华东 1(杭州)、华南 1(深圳)、中国(香港)、欧洲中部 1(法兰克福)、亚太东南 1(新加坡)。

https://open.feishu.cn/open-apis/bot/v2/hook/xxx
TopicTypesarray

事件告警类型列表,事件特有配置。

TopicTypestring

事件告警类型。

  • SLOW - 变慢
  • ERROR - 出错
SLOW
BaselineAlertEnabledboolean

基线告警开关,基线特有配置。

  • true - 开启
  • false - 关闭
false
AlertRecipientTypestring

告警接收人类型。

  • OWNER - 任务责任人
  • OTHER - 指定的人
  • SHIFT_SCHEDULE - 值班表
OWNER
AlertRecipientstring

告警接收人详情。

  • AlertRecipientType 为 OWNER:空
  • AlertRecipientType 为 SHIFT_SCHEDULE:值班表 uid
  • AlertRecipientType 为 OTHER: uid 列表,多个 uid 使用英文 , 分割
123123
RequestIdstring

请求 ID。

ecb967ec-c137-48a5-860****

示例

正常返回示例

JSON格式

{
  "Success": true,
  "ErrorCode": "1031203110005",
  "ErrorMessage": "The specified parameters are invalid",
  "HttpStatusCode": 200,
  "Data": {
    "BaselineId": 1001,
    "BaselineName": "测试基线",
    "ProjectId": 10000,
    "Owner": "9527952****",
    "Priority": 1,
    "BaselineType": "DAILY",
    "OverTimeSettings": [
      {
        "Cycle": 1,
        "Time": "00:00"
      }
    ],
    "Enabled": true,
    "NodeIds": [
      700003559814
    ],
    "AlertEnabled": true,
    "AlertMarginThreshold": 60,
    "AlertSettings": [
      {
        "AlertType": "BASELINE",
        "AlertMethods": [
          "MAIL"
        ],
        "SilenceStartTime": "00:00:00",
        "SilenceEndTime": "00:00:00",
        "AlertInterval": 900,
        "AlertMaximum": 1,
        "DingRobots": [
          {
            "WebUrl": "https://oapi.dingtalk.com/robot/send?access_token=xxx",
            "AtAll": true
          }
        ],
        "Webhooks": [
          "https://open.feishu.cn/open-apis/bot/v2/hook/xxx"
        ],
        "TopicTypes": [
          "SLOW"
        ],
        "BaselineAlertEnabled": false,
        "AlertRecipientType": "OWNER",
        "AlertRecipient": "123123"
      }
    ]
  },
  "RequestId": "ecb967ec-c137-48a5-860****"
}

错误码

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