全部產品
Search
文件中心

DataWorks:GetTopic

更新時間:Oct 09, 2026

呼叫GetTopic取得事件的詳細資訊。

介面說明

前置條件:呼叫本介面前需開通 DataWorks 企業版或旗艦版。TopicId 應使用目標地域中已有事件的 ID,不應直接複用文件範例值。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

TopicId

integer

是

事件的 ID。您可以呼叫 listTopics 取得。

文件範例僅用於展示格式;有效 TopicId 可透過 ListTopics 回應中的 Data.Topics[].TopicId 取得。

1234

返回參數

名稱

類型

描述

樣本值

object

HttpStatusCode

integer

HTTP 返回碼。

200

RequestId

string

本次呼叫的唯一 ID。出現錯誤後,您可以根據該 ID 排查問題。

0000-ABCD-EFGH-IJKLMNOPQ

ErrorMessage

string

錯誤資訊。

The specified parameters are invalid.

ErrorCode

string

錯誤碼。

1031203110005

Success

boolean

呼叫是否成功。

true

Data

object

事件的詳細資訊。

Owner

string

事件負責人的阿里雲 UID。

952795****

TopicName

string

事件的名稱。

1234 error

BaselineStatus

string

基線的狀態,包括 ERROR(異常)、SAFE(安全)、DANGROUS(預警)和 OVER(破線)。

SAFE

ProjectId

integer

事件關聯任務節點所在工作空間的 ID。

123456

NextAlertTime

integer

下次警報時間戳記。

1553524393000

InstanceId

integer

事件關聯的執行個體 ID。

12345

FixTime

integer

事件恢復時間戳記。

1553524393000

BaselineInGroupId

integer

最差基線執行個體的週期號。

1

BaselineBuffer

integer

最差基線執行個體餘量,單位為秒。

3600

TopicType

string

事件的類型,包括 SLOW(變慢)和 ERROR(出錯)。

ERROR

TopicStatus

string

事件的狀態,包括 IGNORE(已忽略)、NEW(新發現)、FIXING(處理中)和 RECOVER(已恢復)。

FIXING

HappenTime

integer

事件發生的時間戳記。事件發生和被發現可能存在時間差。

1553524393000

DealTime

integer

最後處理時間戳記。

1553524393000

DealUser

string

最後處理人的阿里雲 UID。

952795****

BaselineName

string

最差基線執行個體的基線名稱。

Baseline name

BaselineId

integer

最差基線執行個體的基線 ID。

1234

NodeName

string

事件關聯的任務節點名稱。

Node name

AlertTime

integer

首次警報時間戳記。

1553524393000

Buffer

integer

事件的餘量,單位為秒。

1200

Assigner

string

指派人的阿里雲 UID。

952795****

TopicId

integer

事件的 ID。

1234

AddTime

integer

事件發現時間戳記。

1553524393000

NodeId

integer

事件關聯的任務節點 ID。

1234

樣本

正常返回樣本

JSON格式

{
  "HttpStatusCode": 200,
  "RequestId": "0000-ABCD-EFGH-IJKLMNOPQ",
  "ErrorMessage": "The specified parameters are invalid.",
  "ErrorCode": "1031203110005",
  "Success": true,
  "Data": {
    "Owner": "952795****",
    "TopicName": "1234 error",
    "BaselineStatus": "SAFE",
    "ProjectId": 123456,
    "NextAlertTime": 1553524393000,
    "InstanceId": 12345,
    "FixTime": 1553524393000,
    "BaselineInGroupId": 1,
    "BaselineBuffer": 3600,
    "TopicType": "ERROR",
    "TopicStatus": "FIXING",
    "HappenTime": 1553524393000,
    "DealTime": 1553524393000,
    "DealUser": "952795****",
    "BaselineName": "Baseline name",
    "BaselineId": 1234,
    "NodeName": "Node name",
    "AlertTime": 1553524393000,
    "Buffer": 1200,
    "Assigner": "952795****",
    "TopicId": 1234,
    "AddTime": 1553524393000,
    "NodeId": 1234
  }
}

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

500 Forbidden.Not.Server The dataworksAPI service is not available in this area. Please try it in another area.
500 Invalid.Wkbench.Parameter The specified parameters are invalid.
500 InternalError.UserId.Missing An internal system error occurred. Try again later.
500 InternalError.Wkbench.ServiceError An internal error occurred. 服務發生異常。
500 Invalid.Wkbench.TopicNotExist The topic does not exist.
403 Forbidden.Access Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition. 沒有權限,請授權。
429 Throttling.Api.Risk The request for this resource has exceeded your daily available limit.
429 Throttling.System The DataWorks system is busy. Try again later.
429 Throttling.User Your request is too frequent. Try again later.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情。