全部產品
Search
文件中心

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
  }
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情