全部產品
Search

搜尋本產品

    MaxCompute：GetQuotaUsage - 擷取Quota資源消耗資訊

    文件中心

    MaxCompute：GetQuotaUsage - 擷取Quota資源消耗資訊

    更新時間：Dec 18, 2025

    擷取Quota資源消耗資訊

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    odps:GetQuotaUsage

    get

    *Quota

    acs:odps:{#regionId}:{#accountId}:quotas/{#nickName}

    		 無 無

    請求文法

    GET /api/v1/quotas/{nickname}/usage HTTP/1.1

    路徑參數

    名稱

    類型

    必填

    描述

    樣本值
    nickname

    string

    是

    一級 Quota 暱稱。

    os_quota_p

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    tenantId

    string

    否

    租戶 ID。可以通過登入 MaxCompute 控制台，在左側導覽列選擇租戶管理>租戶屬性查看。

    478403690625249
    region

    string

    否

    地區 ID。

    cn-chengdu
    from

    integer

    是

    查詢開始時間點。該時間是指寫入日誌資料時指定的日誌時間。

    • 請求參數 from 和 to 定義的時間區間遵循左閉右開原則，即該時間區間包括區間開始時間點，但不包括區間結束時間點。如果 from 和 to 的值相同，則為無效區間，函數直接返回錯誤。

    • Unix 時間戳記格式，表示從 1970-1-1 00:00:00 UTC 計算起的秒數。

    1669081045
    to

    integer

    是

    查詢結束時間點。該時間是指寫入日誌資料時指定的日誌時間。

    • 請求參數 from 和 to 定義的時間區間遵循左閉右開原則，即該時間區間包括區間開始時間點，但不包括區間結束時間點。如果 from 和 to 的值相同，則為無效區間，函數直接返回錯誤。

    • Unix 時間戳記格式，表示從 1970-1-1 00:00:00 UTC 計算起的秒數。

    1669360870
    subQuotaNickname

    string

    否

    二級 Quota 暱稱。

    ot_tunnel_quota
    aggMethod

    string

    否

    彙總演算法。當擷取計算 Quota 計算資源消耗資料時，為最佳化頁面體驗，每個指標至多支援展示 60 個點，因此當時間範圍大於 1h 時，圖表預設使用區間範圍內（所選時間範圍的分鐘數/60）的平均值彙總資料，您可以根據自身需求更改彙總演算法。

    max
    productId

    string

    否

    Quota 類型。預設為 odps。

    • ODPS：計算 Quota；

    • TUNNEL：Data Transmission Service Quota。

    ODPS
    plotTypes

    array

    否

    圖表類型。

    string

    否

    圖表類型。

    當 productId 為 ODPS 時支援參數：

    • cpu：CPU 資源；

    • memory：記憶體資源； 不填表示兩個指標均需返回。

    當 productId 為 TUNNEL 時必須填寫參數，枚舉值：

    • request：請求並發數；

    • throughput：輸送量；

    • error：錯誤請求數。

    cpu
    yAxisTypes

    array

    否

    資料指標欄位。

    string

    否

    資料指標欄位。

    當 productId 為 ODPS 時無需填寫。

    當 productId 為 TUNNEL 時支援填入 project 名稱，此時返回的結果是專案維度資訊。

    your_project_name

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    請求返回參數。

    requestId

    string

    請求 ID。

    0b87b7a416652014358483492eea0b
    httpCode

    integer

    HTTP 狀態代碼。

    • 1xx：資訊響應 - 請求已接收，正在處理中。

    • 2xx：成功 - 請求動作已被服務端成功接收、理解並接受。

    • 3xx：重新導向 - 請求被重新導向，採取進一步行動以完成請求。

    • 4xx：用戶端錯誤 - 請求包含錯誤請求參、文法或特定請求條件無法滿足。

    • 5xx：服務端錯誤 - 伺服器由於其他原因無法滿足請求。

    200
    errorCode

    string

    錯誤碼。

    OBJECT_NOT_EXIST
    errorMsg

    string

    錯誤描述資訊。

    This object does not exist.
    data

    object

    請求返回結果。

    metrics

    object

    指標結果。

    "timestamps": [1668046140000, 1668065220000], //毫秒 "project1#upload#request": [10, 20], "project1#download#request": [20, 30], "project1#upload#throughput": [50, 50], "project1#download#throughput": [60, 70], "pro2#errorNum": [5, 10]
    plot

    array<object>

    圖表資訊。

    object

    圖表資訊。

    title

    string

    圖表標題。

    專案請求並發數
    type

    string

    圖表類型。

    request
    yAxis

    array

    資料指標欄位。

    string

    資料指標欄位。

    當 productId 為 ODPS 時: cpu 具體類型 memory 具體類型

    當 productId 為 TUNNEL 且填入 project 名稱時： project#operation#type

    project1#download#request

    樣本

    正常返回樣本

    JSON格式

    {
  "requestId": "0b87b7a416652014358483492eea0b",
  "httpCode": 200,
  "errorCode": "OBJECT_NOT_EXIST",
  "errorMsg": "This object does not exist.",
  "data": {
    "metrics": {
      "test": "test",
      "test2": 1
    },
    "plot": [
      {
        "title": "專案請求並發數",
        "type": "request",
        "yAxis": [
          "project1#download#request"
        ]
      }
    ]
  }
}

    錯誤碼

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

    變更歷史

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