ListJobMetric - 获取作业性能指标 - 云原生大数据计算服务 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
          ]
        ]
      }
    ]
  }
}

错误码

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

变更历史

更多信息，参考变更详情。