すべてのプロダクト
Search
ドキュメントセンター

MaxCompute:ListStoragePartitionsInfo

最終更新日:May 11, 2026

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:ListStoragePartitionsInfo

get

*Storage

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

なし なし

リクエスト構文

GET /api/v1/observations/analysis/storage/projects/{project}/tables/{table}/partitionsInfo HTTP/1.1

パスパラメータ

パラメーター

必須 / 任意

説明

project

string

必須

MaxCompute プロジェクト名です。

odps_project

table

string

必須

テーブル名です。

bank_data

リクエストパラメーター

パラメーター

必須 / 任意

説明

tenantId

string

任意

テナント ID です。この ID は、MaxCompute コンソールで [Tenant Management] > [Tenant Properties] に移動して確認できます。

40713753659****

region

string

任意

リージョン ID です。

cn-beijing

date

string

必須

統計を取得する日付です。日付は YYYYMMdd フォーマットである必要があります。

20241205

schema

string

任意

テーブルが含まれるスキーマです。

schema

partitionPrefix

string

任意

パーティション名です。このパラメーターはファジーマッチングをサポートします。

20241201

types

array

任意

ストレージタイプです。

string

任意

有効な値:

  • standardStorage:標準ストレージ。

  • lowFreqStorage:低頻度アクセスストレージ。

  • longTermStorage:アーカイブストレージ。

standardStorage

orderColumn

string

任意

ソートする列です。

totalFrequency

ascOrder

boolean

任意

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

false

pageSize

integer

任意

1 ページあたりに返すエントリ数です。デフォルト値:10。

10

pageNumber

integer

任意

ページ番号です。

1

レスポンスフィールド

フィールド

説明

object

応答パラメーターです。

requestId

string

リクエスト ID です。

0be3e0bd16661643917136451ebf55

httpCode

integer

HTTP ステータスコード です。

  • 1xx:情報レスポンス - リクエストは受信され、処理中です。

  • 2xx:成功 - リクエストが正常に受信、理解、および受理されました。

  • 3xx:リダイレクト - リクエストを完了するには、さらなるアクションが必要です。

  • 4xx:クライアントエラー - リクエストに無効なパラメーターまたは構文が含まれているか、リクエストを処理できません。

  • 5xx:サーバーエラー - サーバーが有効なリクエストの処理に失敗しました。

200

errorCode

string

エラーコードです。

OBJECT_NOT_EXIST

errorMsg

string

エラーメッセージです。

This object does not exist.

data

object

返されたデータです。

storagePartitionInfoList

array<object>

パーティションのストレージ情報です。

object

単一パーティションのストレージ情報です。

projectName

string

プロジェクト名です。

odps_project

schemaName

string

スキーマ名です。

schema

tableName

string

テーブル名です。

bank_data

partition

string

パーティション名です。

ds=20241201

isPartitioned

boolean

テーブルがパーティションテーブルであるかどうかを示します。この API はパーティションのデータのみを返すため、このパラメーターは無視できます。

false

type

string

オブジェクトの型です。値は常に PARTITION です。

PARTITION

storageType

string

ストレージタイプです。有効な値:

  • standard:標準ストレージ

  • lowfrequency:低頻度アクセスストレージ

  • longterm:アーカイブストレージ

standard

totalFrequency

integer

アクセス頻度です。

説明
  • アクセスアクティビティには以下が含まれます:

説明
  • テーブルが SQL コンピューティングタスクの入力として使用されます。

  • テーブルがトンネル 経由でダウンロードされます。

  • Storage API の Read オペレーションを呼び出すことでテーブルデータが読み取られます。パーティションテーブルのパーティションレベルのデータは利用できません。各アクセスアクティビティにより、アクセス頻度が 1 増加します。

  • このメトリックのデータ収集は 2023 年 7 月に段階的に開始されました。そのため、それ以降アクセスされていないテーブル、または ALGO ジョブや Hologres からの直接読み取りによってのみアクセスされるテーブルでは、アクセス頻度が記録されない場合があります。

10

totalInputAmount

number

アクセスされた合計データ量です。

説明

すべてのアクセス操作から読み取られたデータの累積量です。

1

totalInputAmountUnit

string

アクセスされた合計データ量の単位です。

GB

fileCount

integer

ファイル数です。

2

fileSize

number

ストレージサイズです。

1

fileSizeUnit

string

ストレージサイズの単位です。

GB

rate

number

過去 {$recentDays} 日間の合計ストレージ使用量の変動率です。この API はこのパラメーターを返しません。

1%

lastAccessTime

integer

パーティションの最終アクセス時間です。

説明

このメトリックのデータ収集は 2023 年 7 月に段階的に開始されました。そのため、それ以降アクセスされていないパーティション、または ALGO ジョブや Hologres からの直接読み取りによってのみアクセスされるパーティションでは、lastAccessTime が記録されない場合があります。

1694589365

date

string

統計の対象となる日付です。

20241205

totalCount

integer

総エントリ数です。

57

pageNumber

integer

返されたデータのページ番号です。

1

pageSize

integer

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

10

成功レスポンス

JSONJSON

{
  "requestId": "0be3e0bd16661643917136451ebf55",
  "httpCode": 200,
  "errorCode": "OBJECT_NOT_EXIST",
  "errorMsg": "This object does not exist.",
  "data": {
    "storagePartitionInfoList": [
      {
        "projectName": "odps_project",
        "schemaName": "schema",
        "tableName": "bank_data",
        "partition": "ds=20241201",
        "isPartitioned": false,
        "type": "PARTITION",
        "storageType": "standard",
        "totalFrequency": 10,
        "totalInputAmount": 1,
        "totalInputAmountUnit": "GB",
        "fileCount": 2,
        "fileSize": 1,
        "fileSizeUnit": "GB",
        "rate": 0,
        "lastAccessTime": 1694589365
      }
    ],
    "date": "20241205",
    "totalCount": 57,
    "pageNumber": 1,
    "pageSize": 10
  }
}

エラーコード

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

変更履歴

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