All Products
Search
Document Center

AnalyticDB:DescribeJobResourceUsage

最終更新日:Nov 10, 2025

Retrieves resource usage statistics for a job.

Operation description

For information about the endpoints of AnalyticDB for MySQL, see Endpoints .

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
DBClusterIdstringYes

The ID of the AnalyticDB for MySQL Data Lakehouse Edition cluster.

am-uf6g8w25jacm7****
StartTimestringYes

The beginning of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

2023-02-04T03:45:00Z
EndTimestringYes

The end of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. The end time must be later than the start time.

2023-03-17T16:00:00Z

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

RequestIdstring

The request ID.

1AD222E9-E606-4A42-BF6D-8A4442913CEF
Codeinteger

The HTTP status code.

200
Dataobject

The queried resource usage.

DBClusterIdstring

The ID of the AnalyticDB for MySQL Data Lakehouse Edition cluster.

amv-clusterxxx
StartTimestring

The start time of the query. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

2023-05-22T16:00:00Z
EndTimestring

The end time of the query. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

2023-05-23T16:00:00Z
JobAcuUsagearray<object>

The AnalyticDB compute unit (ACU) usage of the job resource group.

jobAcUsageobject
JobIdstring

The job ID.

1592
ResourceGroupNamestring

The name of the job resource group.

job_default
JobStartTimestring

The start time of the job. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

2023-05-22T16:00:00Z
JobEndTimestring

The end time of the job. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

2023-05-23T16:00:00Z
AcuUsageDetailobject

The ACU usage.

TotalAcuNumberfloat

The total number of ACUs.

32ACU
ReservedAcuNumberfloat

The number of ACUs for the reserved resources.

16ACU
ElasticAcuNumberfloat

The number of ACUs for the elastic resources.

16ACU
SpotAcuNumberfloat

The number of spot ACUs.

16ACU
SpotAcuPercentagefloat

The percent of spot ACUs.

0.9

Examples

Sample success responses

JSONformat

{
  "RequestId": "1AD222E9-E606-4A42-BF6D-8A4442913CEF",
  "Code": 200,
  "Data": {
    "DBClusterId": "amv-clusterxxx",
    "StartTime": "2023-05-22T16:00:00Z",
    "EndTime": "2023-05-23T16:00:00Z\n",
    "JobAcuUsage": [
      {
        "JobId": 1592,
        "ResourceGroupName": "job_default",
        "JobStartTime": "2023-05-22T16:00:00Z\n",
        "JobEndTime": "2023-05-23T16:00:00Z",
        "AcuUsageDetail": {
          "TotalAcuNumber": 0,
          "ReservedAcuNumber": 0,
          "ElasticAcuNumber": 0,
          "SpotAcuNumber": 0,
          "SpotAcuPercentage": 0.9
        }
      }
    ]
  }
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2024-06-30The response structure of the API has changedView Change Details
2023-12-06The internal configuration of the API is changed, but the call is not affectedView Change Details