すべてのプロダクト
Search

このプロダクト

    MaxCompute:ListStorageTablesInfo

    ドキュメントセンター

    MaxCompute:ListStorageTablesInfo

    最終更新日:Dec 18, 2025

    MaxCompute プロジェクトのテーブルストレージの詳細をクエリします。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    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 コンソールにログインし、左側のナビゲーションウィンドウで [テナント] > [テナントプロパティ] を選択してテナント ID を表示できます。

    28074710977****
    region

    string

    任意

    リージョン ID。

    cn-beijing
    date

    string

    必須

    統計が収集される日付 (日単位)。このパラメーターを YYYYMMdd 形式の値に設定します。

    20241205
    recentDays

    integer

    任意

    比較対象の最近の日数。

    1
    schema

    string

    任意

    スキーマの名前。

    schema
    tablePrefix

    string

    任意

    あいまい一致に使用するテーブルの名前。

    bank
    types

    array

    任意

    ストレージタイプ。

    string

    任意

    ストレージタイプ。

    standardStorage
    orderColumn

    string

    任意

    ソート列。

    totalFrequency
    ascOrder

    boolean

    任意

    データを昇順でソートするかどうかを指定します。

    false
    pageSize

    integer

    任意

    1ページあたりのエントリ数。デフォルト値：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
    tableName

    string

    テーブル名。

    bank_data
    isPartitioned

    boolean

    テーブルがパーティションテーブルであるかどうかを示します。

    false
    storageType

    string

    テーブルのストレージタイプ。

    • standard

    • lowfrequency

    • longterm

    • unknown：この値は、テーブルがパーティションテーブルの場合に返されます。ListStoragePartitionsInfo 操作を呼び出して、各パーティションのストレージタイプをクエリできます。

    standard
    lastAccessTime

    integer

    テーブルが最後にアクセスされた時間。この値は、テーブルが非パーティションテーブルの場合に返されます。

    説明

    データ収集メソッドは 2023 年 7 月からアップグレードされました。アップグレード後にデータにアクセスしない場合、または ALGO ジョブや Hologres の直接読み取りメソッドを使用してデータにアクセスする場合、最終アクセス時間は収集できません。

    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 によってダウンロードされる。

    • テーブルが Storage API を呼び出すことによって読み取られる。パーティションテーブルのパーティションの粒度は利用できません。アクセス操作が実行されるたびに、アクセス頻度は 1 ずつインクリメントされます。

    • データ収集メソッドは 2023 年 7 月からアップグレードされました。アップグレード後にデータにアクセスしない場合、または ALGO ジョブや Hologres の直接読み取りメソッドを使用してデータにアクセスする場合、アクセス頻度は収集できません。

    10
    totalInputAmount

    number

    アクセスされたデータの総量。

    説明

    すべてのアクセス動作によって読み取られるデータの量。

    1
    totalInputAmountUnit

    string

    アクセスされたデータの総量の単位。

    GB
    date

    string

    統計が収集された日付。

    20241205
    totalCount

    integer

    返されたエントリの総数。

    1
    pageNumber

    integer

    ページ番号。

    1
    pageSize

    integer

    1ページあたりのエントリ数。

    10

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。