使用ListJobMetric擷取運行結束的作業效能指標-雲原生MaxCompute MaxCompute-阿里雲

擷取運行結束的作業的效能指標。

調試

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

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

odps:ListJobMetric

list

*全部資源

*

無

請求文法

POST /api/v1/jobs/metric HTTP/1.1

請求參數

名稱	類型	必填	描述	樣本值
startTime	integer	是	查詢時間範圍：開始時間。	1735534322
endTime	integer	是	查詢時間範圍：結束時間。	1735536322
body	object	否	請求體參數。
metric	string	否	觀測指標資訊。枚舉值： inputBytes : inputBytes memory : memory num : num inputBytesPerCu : inputBytesPerCu cpu : cpu runningTime : runningTime	num
type	string	否	觀測指標的類型資訊。枚舉值： p1 : 僅 runningTime 支援 p99 : 僅 runningTime 支援 total : 僅 num，cpu，memory，inputBytes，inputBytesPerCu 支援 min : 僅 runningTime 支援 avg : 僅 runningTime 支援 max : 僅 runningTime 支援 p5 : 僅 runningTime 支援 p90 : 僅 runningTime 支援 p50 : 僅 runningTime 支援 p95 : 僅 runningTime 支援 p10 : 僅 runningTime 支援	total
project	array	否	MaxCompute 專案名稱列表（用於過濾）。
	string	否	專案名稱。	project_a
quota	array	否	作業使用的計算 Quota 暱稱列表（用於過濾）。
	string	否	計算 Quota 暱稱。	os_PayAsYouGoQuota
period	integer	否	監控統計周期。枚舉值： 3600 : 3600 86400 : 86400	3600
group	string	否	分組依據。說明可選值有：project，quota，type，status。含義： project：按專案分組彙總; quota：按配額分組彙總; type：按作業類型分組彙總; status：按作業狀態分組彙總。枚舉值： quota : quota project : project type : type status : status	project

返回參數

名稱	類型	描述	樣本值
	object	PopResult
requestId	string	請求 ID。	0be3e0aa16667684362147582e038f
httpCode	integer	HTTP 狀態代碼。 1xx：資訊響應 - 請求已接收，正在處理中。 2xx：成功 - 請求動作已被服務端成功接收、理解並接受。 3xx：重新導向 - 請求被重新導向，採取進一步行動以完成請求。 4xx：用戶端錯誤 - 請求包含錯誤請求參、文法或特定請求條件無法滿足。 5xx：服務端錯誤 - 伺服器由於其他原因無法滿足請求。	200
errorCode	string	錯誤碼。	OBJECT_NOT_EXIST
errorMsg	string	錯誤資訊。	This object does not exist.
data	object	請求返回結果。
category	string	指標類型。	job
name	string	指標名稱。	num
period	integer	監控統計周期。	3600
metrics	array<object>	指標詳情。
	array<object>	指標值。
metric	object	指標相關資訊。
	string	指標資訊。說明可能值有：type，project，quota，group。	"type": "total"
values	array	指標數值資訊。
	array	指標數值列表。
	number	size 為 2 的列表，第一列表示時間戳記，第二列表示對應數值。	1736679600, 3

樣本

正常返回樣本

JSON格式

{
  "requestId": "0be3e0aa16667684362147582e038f",
  "httpCode": 200,
  "errorCode": "OBJECT_NOT_EXIST",
  "errorMsg": "This object does not exist.",
  "data": {
    "category": "job",
    "name": "num",
    "period": 3600,
    "metrics": [
      {
        "metric": {
          "key": "\"type\": \"total\""
        },
        "values": [
          [
            0
          ]
        ]
      }
    ]
  }
}

錯誤碼

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

變更歷史

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