調用QueryQuotaMetric API查詢Quota資源消耗的時序資訊-雲原生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

路徑參數

名稱	類型	必填	描述	樣本值
metric	string	是	觀測指標名稱。僅支援 cpu 和 memory	cpu

請求參數

名稱	類型	必填	描述	樣本值
startTime	integer	是	查詢時間範圍：開始時間。	1735534322
endTime	integer	是	查詢時間範圍：結束時間。	1735536322
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
subMetric	string	否

返回參數

名稱	類型	描述	樣本值
	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>	指標值。
	array<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
          ]
        ]
      }
    ]
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。