全部產品
Search

搜尋本產品

    MaxCompute：ListStorageTablesInfo - 擷取表格儲存體明細

    文件中心

    MaxCompute：ListStorageTablesInfo - 擷取表格儲存體明細

    更新時間：Dec 18, 2025

    擷取某個MaxCompute專案內的表格儲存體明細。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    odps:ListStorageTablesInfo

    get

    *Storage

    acs:odps:{#regionId}:{#accountId}:storage/{#project}

    		 無 無

    請求文法

    GET /api/v1/observations/analysis/storage/projects/{project}/tablesInfo HTTP/1.1

    路徑參數

    名稱

    類型

    必填

    描述

    樣本值
    project

    string

    是

    MaxCompute 專案名稱。

    odps_project

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    tenantId

    string

    否

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

    28074710977****
    region

    string

    否

    地區 ID。

    cn-beijing
    date

    string

    是

    統計日期，以天為層級，時間參數填寫為YYYYMMdd。

    20241205
    recentDays

    integer

    否

    同比對比天數。

    1
    schema

    string

    否

    歸屬 Schema。

    schema
    tablePrefix

    string

    否

    表名稱（模糊比對）。

    bank
    types

    array

    否

    儲存類型。

    string

    否

    儲存類型。

    standardStorage
    orderColumn

    string

    否

    排序列。

    totalFrequency
    ascOrder

    boolean

    否

    是否升序排列。

    false
    pageSize

    integer

    否

    每頁返回數目，預設為 10。

    10
    pageNumber

    integer

    否

    分頁頁碼。

    1

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    請求返回參數。

    requestId

    string

    請求 ID。

    0bc12e6a16679892465424670db3eb
    httpCode

    integer

    HTTP 狀態代碼。

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

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

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

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

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

    200
    errorCode

    string

    錯誤碼。

    OBJECT_NOT_EXIST
    errorMsg

    string

    錯誤資訊。

    This object does not exist.

    data

    object

    請求返回結果。

    storageTableInfoList

    array<object>

    表格儲存體資訊列表。

    object

    表格儲存體資訊列表。

    date

    string

    統計日期（不會返回）。

    20241205
    projectName

    string

    專案名稱。

    odps_project
    schemaName

    string

    Schema 名稱。

    schema
    tableName

    string

    表名稱。

    bank_data
    isPartitioned

    boolean

    是否分區表。

    false
    storageType

    string

    表格儲存體類型。

    • standard：標準儲存；

    • lowfrequency：低頻儲存；

    • longterm：長期儲存；

    • unknown：當表為分區表時返回此值，需調用 ListStoragePartitionsInfo 查詢各分區的儲存類型。

    standard
    lastAccessTime

    integer

    表的資料最後訪問時間，當表為非分區表時有此傳回值。

    說明

    該資料從 2023 年 7 月陸續升級採集，在升級後沒有被訪問過或者通過 ALGO 作業、Hologres 直讀方式訪問的無法採集到 last_access_time。

    1694589365
    totalStorageFileCount

    integer

    總檔案數。

    2
    totalStorage

    number

    總儲存用量。分區表為各分區儲存用量之和。若各分區儲存類型不一致，則為各類型儲存用量之和。

    600
    totalStorageUnit

    string

    儲存用量單位。

    KB
    rate

    number

    總儲存量近{$recentDays}天同比。

    0
    standardStorageFileCount

    integer

    標準隱藏檔數。

    2
    standardStorage

    number

    標準儲存用量。

    600
    standardStorageUnit

    string

    標準儲存用量單位。

    KB
    longTermStorageFileCount

    integer

    長期隱藏檔數。

    0
    longTermStorage

    number

    長期儲存用量。

    0
    longTermStorageUnit

    string

    長期儲存用量單位。

    B
    lowFreqStorageFileCount

    integer

    低頻隱藏檔數。

    0
    lowFreqStorage

    number

    低頻儲存用量。

    0
    lowFreqStorageUnit

    string

    低頻儲存用量單位。

    B
    totalFrequency

    integer

    訪問頻次。

    說明

    • 訪問行為包括：

    說明

    • 表作為 SQL 計算任務中的輸入表。

    • 表被 Tunnel 下載。

    • 表被 StorageAPI 呼叫 Read（分區表的分區粒度資料暫無）。訪問每增加一次，訪問頻次+1。

    • 該資料從 2023 年 7 月陸續升級統計，在升級後沒有被訪問過或者通過 ALGO 作業、Hologres 直讀方式訪問的將無法統計至訪問頻次。

    10
    totalInputAmount

    number

    訪問資料總量。

    說明

    所有訪問行為讀取的資料量。

    1
    totalInputAmountUnit

    string

    訪問資料總量單位。

    GB
    date

    string

    統計日期。

    20241205
    totalCount

    integer

    返回結果的總數量。

    1
    pageNumber

    integer

    分頁頁碼。

    1
    pageSize

    integer

    每頁記錄數。

    10

    樣本

    正常返回樣本

    JSON格式

    {
  "requestId": "0bc12e6a16679892465424670db3eb",
  "httpCode": 200,
  "errorCode": "OBJECT_NOT_EXIST",
  "errorMsg": "This object does not exist.\n",
  "data": {
    "storageTableInfoList": [
      {
        "date": "20241205",
        "projectName": "odps_project",
        "schemaName": "schema",
        "tableName": "bank_data",
        "isPartitioned": false,
        "storageType": "standard",
        "lastAccessTime": 1694589365,
        "totalStorageFileCount": 2,
        "totalStorage": 600,
        "totalStorageUnit": "KB",
        "rate": 0,
        "standardStorageFileCount": 2,
        "standardStorage": 600,
        "standardStorageUnit": "KB",
        "longTermStorageFileCount": 0,
        "longTermStorage": 0,
        "longTermStorageUnit": "B",
        "lowFreqStorageFileCount": 0,
        "lowFreqStorage": 0,
        "lowFreqStorageUnit": "B",
        "totalFrequency": 10,
        "totalInputAmount": 1,
        "totalInputAmountUnit": "GB"
      }
    ],
    "date": "20241205",
    "totalCount": 1,
    "pageNumber": 1,
    "pageSize": 10
  }
}

    錯誤碼

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

    變更歷史

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