QueryQuotaMetric - 计算资源消耗信息_云原生大数据计算服务 MaxCompute(MaxCompute)-阿里云帮助中心

查看quota资源消耗的时序信息

调试

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

调试

授权信息

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

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

操作

访问级别

资源类型

条件关键字

关联操作

odps:QueryQuotaMetric

list

*Quota

acs:odps:{#regionId}:{#accountId}:quota/{#metric}

无

请求语法

POST /api/v1/observations/quota/{metric} HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
startTime	integer	是	查询时间范围：开始时间。	1735534322
endTime	integer	是	查询时间范围：结束时间。	1735536322
metric	string	是	观测指标名称。仅支持 cpu 和 memory	cpu
strategy	string	否	数据聚合策略。默认 max。仅支持 max 和 avg。数据的采集频率是 1 分钟。当查询的时间范围较大时，数据展示的自适应步长会超过 1 分钟，此时指标会进行聚合。该参数即指定数据的聚合逻辑。	max
body	object	否	请求体参数
nickname	string	否	一级 Quota 昵称。必填参数。	os_sns_p
subQuotaNickname	string	否	二级 Quota 昵称。	os_sns
interval	integer	否	固定间隔，单位为秒。默认为空，表示使用系统自适应间隔策略。自适应间隔策略：查询时间范围在 6 小时内时间隔 60s，24 小时内时 300s，72 小时内时 900s，超过 72 小时则 1800s。指定间隔：仅支持 60，300，900。且要求查询间隔在 72 小时内。	60

返回参数

名称	类型	描述	示例值
	object	PopResult
requestId	string	请求 id。	0b87b7b316643495896551555e855b
httpCode	integer	HTTP 状态码。 1xx：信息响应 - 请求已接收，正在处理中。 2xx：成功 - 请求动作已被服务端成功接收、理解并接受。 3xx：重定向 - 请求被重定向，采取进一步行动以完成请求。 4xx：客户端错误 - 请求包含错误请求参、语法或特定请求条件无法满足。 5xx：服务端错误 - 服务器由于其他原因无法满足请求。	200
errorCode	string	错误码。	success
errorMsg	string	错误信息。	plan \"***\" does not exist
data	object	返回数据
category	string	不支持。	不支持。
name	string	观测指标名称。	cpu
period	integer	监控数据步长。	60
metrics	array<object>	指标值。
	object	指标值。
metric	object	指标元数据信息。
	string	指标元数据信息。 unit：元数据单位。指标为 cpu 时，单位是 Core。指标为 memory 时，单位是 GB。 type：元数据类型。查询指标类别为 cpu 时，元数据类型包括 totalMaxCpu、totalUsedCpu、adhocCpu、adhocUsedCpu、maxCpu、minCpu、requestCpu、usedCpu、elasticMaxCpu、elasticUsedCpu。查询指标类别为 memory 时，元数据类型包括 totalMaxMem、totalUsedMem、adhocMem、adhocUsedMem、elasticMaxMem、elasticUsedMem、maxMem、minMem、usedMem。	totalUsedCpu
values	array	时序数据。
	array	长度为 2，分别是时间戳和数值。
	number	长度为 2，分别是时间戳和数值。	[1757571840,10]

示例

正常返回示例

JSON格式

{
  "requestId": "0b87b7b316643495896551555e855b",
  "httpCode": 200,
  "errorCode": "success",
  "errorMsg": "plan \\\"***\\\" does not exist",
  "data": {
    "category": "不支持。",
    "name": "cpu",
    "period": 60,
    "metrics": [
      {
        "metric": {
          "key": "totalUsedCpu"
        },
        "values": [
          [
            0
          ]
        ]
      }
    ]
  }
}

错误码

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

变更历史

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