All Products
Search
Document Center

MaxCompute:ListComputeMetricsBySignature

Last Updated:Apr 16, 2026

View detailed compute usage for jobs by Signature.

Operation description

Gets job details by signature.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST /api/v1/computeMetrics/listBySignature HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

body

object

No

The request body. For example, {"startDate":1775809442560,"endDate":1776327842560,"pageNumber":1,"pageSize":10}

projectNames

array

No

The project names.

string

No

The name of a project.

prj

startDate

integer

No

The start time for the query. This value is a UNIX timestamp representing milliseconds.

1715393576201

endDate

integer

No

The end time for the query. This value is a UNIX timestamp representing milliseconds.

1718590596556

instanceId

string

No

The instance ID.

20240730****ddlr

jobOwner

string

No

The job owner.

ALIYUN$7632***@aliyun.com

signature

string

No

The SQL job signature.

m4S/2HipBVngCX94MNIAqmM7Ov4=

pageNumber

integer

No

The page number.

1

pageSize

integer

No

The number of entries to return on each page. Default value: 10.

10

types

array

No

The metering type.

  • ComputationSql: the metering data of SQL jobs that are performed on internal tables.

string

No

The metering type.

  • ComputationSql: the metering data of SQL jobs that are performed on internal tables.

ComputationSql

Response elements

Element

Type

Description

Example

object

The response data. Example: { "data":{ "pageNumber":1, "signatureComputeMetrics":[ { "unit":"GBCplx", "signature":"efb4a514af076dd95a5f632b99a27779", "usage":32.67788110114634 }, { "unit":"GBCplx", "signature":"726c63958156dacbbf80d0ad6d78fffd", "usage":32.67767215706408 }, { "unit":"GBCplx", "signature":"031d508ccfeb4b843611d527f16f99ae", "usage":30.016094097867608 }, { "unit":"GBCplx", "signature":"a43fdcba21156b989741648cbfcf7ffd", "usage":20.4983083428815 }, { "unit":"GBCplx", "signature":"1fc9ad694038df11f3f7502e903fceaf", "usage":19.928280484862626 }, { "unit":"GBCplx", "signature":"cd56e2bca5904b5085eab38f5e07b16e", "usage":19.34378239326179 }, { "unit":"GBCplx", "signature":"612832751a56fa110cb431d8f92cc330", "usage":19.343725475482643 }, { "unit":"GBCplx", "signature":"3089ba593a115a4ed8a5aed589a068e7", "usage":11.065628196112812 }, { "unit":"GBCplx", "signature":"", "usage":0.1802469869144261 }, { "unit":"GBCplx", "signature":"0af31eba01d37a5db55b418438a9ed41", "usage":0.0360673195682466 } ], "pageSize":10, "totalCount":10 }, "requestId":"1aed17ac17763278608577024d0001" }

requestId

string

The request ID.

0a06dc0a17495216593736061e45a3

httpCode

integer

The HTTP status code.

  • 1xx: Informational - The server has received the request and is processing it.

  • 2xx: Success - The server successfully received, understood, and accepted the request.

  • 3xx: Redirection - Further action is required to complete the request.

  • 4xx: Client Error - The request contains invalid syntax or cannot be fulfilled.

  • 5xx: Server Error - The server failed to fulfill a valid request.

200

data

object

The data payload of the response.

signatureComputeMetrics

array<object>

An array containing the compute metrics for each signature.

array<object>

The compute metrics for a signature.

signature

string

The signature of the SQL job.

YF3JMiEXEvZVmGzUXz6G4MtWVJk=

projectNames

array

A list of project names.

string

The name of a project.

projectName

usage

number

The compute usage.

32.67767215706408

unit

string

The unit of compute usage.

GBCplx

instances

array<object>

A list of instances.

object

An instance.

instanceId

string

The instance ID.

20260124052241299gdxd3wveqsj

startTime

integer

The start time of the instance.

1765765291000

endTime

integer

The end time of the instance.

1766780295000

totalCount

integer

The total number of entries that match the query.

60

pageNumber

integer

The current page number.

1

pageSize

integer

The number of entries on the current page.

10

Examples

Success response

JSON format

{
  "requestId": "0a06dc0a17495216593736061e45a3",
  "httpCode": 200,
  "data": {
    "signatureComputeMetrics": [
      {
        "signature": "YF3JMiEXEvZVmGzUXz6G4MtWVJk=",
        "projectNames": [
          "projectName"
        ],
        "usage": 32.67767215706408,
        "unit": "GBCplx",
        "instances": [
          {
            "instanceId": "20260124052241299gdxd3wveqsj",
            "startTime": 1765765291000,
            "endTime": 1766780295000
          }
        ]
      }
    ],
    "totalCount": 60,
    "pageNumber": 1,
    "pageSize": 10
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.