ListJobMetric - 获取作业性能指标

获取运行结束的作业的性能指标。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
odps:ListJobMetriclist
*全部资源
*

请求语法

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

请求参数

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

查询时间范围:开始时间。

1735534322
endTimelong

查询时间范围:结束时间。

1735536322
bodyobject

请求体参数。

metricstring

观测指标信息。

枚举值:
  • inputBytesinputBytes
  • memorymemory
  • numnum
  • inputBytesPerCuinputBytesPerCu
  • cpucpu
  • runningTimerunningTime
num
typestring

观测指标的类型信息。

枚举值:
  • p1runningTime支持
  • p99runningTime支持
  • totalnum,cpu,memory,inputBytes,inputBytesPerCu支持
  • minrunningTime支持
  • avgrunningTime支持
  • maxrunningTime支持
  • p5runningTime支持
  • p90runningTime支持
  • p50runningTime支持
  • p95runningTime支持
  • p10runningTime支持
total
projectarray

MaxCompute 项目名称列表(用于过滤)。

projectstring

项目名称。

project_a
quotaarray

作业使用的计算 Quota 昵称列表(用于过滤)。

quotastring

计算 Quota 昵称。

os_PayAsYouGoQuota
periodlong

监控统计周期。

枚举值:
  • 36003600
  • 8640086400
3600
groupstring

分组依据。

说明 可选值有:project,quota,type,status。含义:
  • project:按项目分组聚合;
  • quota:按配额分组聚合;
  • type:按作业类型分组聚合;
  • status:按作业状态分组聚合。
  • project

    返回参数

    名称类型描述示例值
    object

    PopResult

    requestIdstring

    请求 ID。

    0be3e0aa16667684362147582e038f
    httpCodeinteger

    HTTP 状态码。

    • 1xx:信息响应 - 请求已接收,正在处理中。
    • 2xx:成功 - 请求动作已被服务端成功接收、理解并接受。
    • 3xx:重定向 - 请求被重定向,采取进一步行动以完成请求。
    • 4xx:客户端错误 - 请求包含错误请求参、语法或特定请求条件无法满足。
    • 5xx:服务端错误 - 服务器由于其他原因无法满足请求。
    200
    errorCodestring

    错误码。

    OBJECT_NOT_EXIST
    errorMsgstring

    错误信息。

    This object does not exist.
    dataobject

    请求返回结果。

    categorystring

    指标类型。

    job
    namestring

    指标名称。

    num
    periodlong

    监控统计周期。

    3600
    metricsarray<object>

    指标详情。

    metricobject

    指标值。

    metricobject

    指标相关信息。

    string

    指标信息。

    说明 可能值有:type,project,quota,group。
    "type": "total"
    valuesarray

    指标数值信息。

    valuearray

    指标数值列表。

    itemdouble

    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
              ]
            ]
          }
        ]
      }
    }

    错误码

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